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About This Book 


What this book is about 


CBIOS for IBM PS/2 Computers and Compatibles is a detailed technical ref- 
erence that describes the CBIOS, the portion of the PS/2 ROM BIOS de- 
signed to support single-tasking operating systems such as MS-DOS. 

The information provided in this book is applicable to all Micro Channel 
Architecture-based (MCA) and non—-MCA-based IBM PS/2 and compatible 
computers, ranging from Models 25 and 30 through Model 80. 


Who should read this book 


CBIOS for IBM PS/2 Computers and Compatibles provides the most compre- 
hensive source of information about the IBM PS/2 and compatible CBIOS 
available today. It can be used by anyone interested in learning more about 
their PS/2 or compatible computer. 


Applications programmers and device driver developers will find a thorough 
discussion of each CBIOS device service and function, including the CBIOS 
VGA-compatible video service. In addition, CBIOS for IBM PS/2 Computers 
and Compatibles defines, to the bit level, all IBM PS/2 and compatible |/O 
port addresses and CBlOS-related CMOS RAM and system RAM data. 


Hardware technicians and other system troubleshooters will appreciate the 
complete list of all CBIOS-generated error messages, their likely causes, 
and suggested solutions. 
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What we assume you know 


This book assumes a basic knowledge of 80x86 assembly language program- 
ming concepts, PC architecture, and operating system concepts. If you are 
new to these subjects, use this book along with some of the excellent intro- 
ductory books listed at the end of this book. 


How to find information 


CBIOS for IBM PS/2 Computers and Compatibles is organized into two major 
parts. Chapters 1-6 provide a general introduction to CBIOS concepts and 
describe how to use CBIOS services. Chapters 7-16 describe the individual 
CBIOS services and serve as a technical reference. Appendix A provides a 
comprehensive list of potential error messages. Appendix B provides infor- 
mation on the 8042-based Keyboard/Mouse Controller. Appendix C describes 
the hardware environment needed to implement 8086-based systems. Most 
readers will want to read chapters 1-6 first to get a basic grasp of the 
CBIOS features before turning to the individual service descriptions. 


Each service-specific chapter (7-16) is organized in a similar fashion. There 
is a description of the service and the hardware environment of this service, 
a discussion on how errors are handled for this service, and complete de- 
scriptions of each service function. The function descriptions include an 
explanation of what the function does, the function’s required inputs and 
Outputs, and any special programming considerations or hardware 
“gotcha’s” associated with the function. 


Other volumes in this series 


CBIOS for IBM PS/2 Computers and Compatibles is one of several volumes 
about BIOS software in the Phoenix Technical Reference Series published by 
Addison-Wesley. Other volumes are: 


ABIOS for IBM PS/2 Computers and Compatibles — a complete 
technical reference describing the portion of a PS/2 BIOS that 
supports multitasking operating systems such as OS/2. 


System BIOS for IBM PC/XTIAT Computers and Compatibles — a 
complete technical reference for the BIOS in all standard architec- 
ture computers. 


The volumes of this series are a natural companion for anyone who owns 
and programs an IBM PC, XT, AT, or PS/2 model, or any compatible 
system. 
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Acronyms and Abbreviations 


The following abbreviations and acronyms are used in this manual: 


ASCIl 
ASIC 


American Standard Code for Information Interchange 
Application—Specific Integrated Circuit 
Binary 

Binary coded decimal 

Basic input/output system 

Bits per second 

Common data area 

Color graphics adapter 

Cyclic redundancy check 
Complementary metal oxide semiconductor 
Direct memory access 

Device service routine 

Error checking and correction 
Enhanced graphics adapter 

End of interrupt 

Enhanced small device interface 
Function transfer table 
Hexadecimal 

Interrupt 

Input/Output 

Interrupt request line 

Interrupt service routine 
Kilobytes 

Kilobits per second 

Logical ID 

Least significant byte 

Large scale integration 
Megabytes 

Multicolor graphics array 
Monochrome Display Adapter 
Modified frequency modulation 
Megahertz 
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Acronyms and Abbreviations, Continued 


MSB Most significant byte 

NMI Nonmaskable interrupt 
OS/2 Operating System/2 

PGA Professional graphics adapter 
POST Power-on seif test 

PTL Phoenix Technologies Ltd. 
RAM Random access memory 
RB Request block 

RLL Run length limited 

ROM Read-only memory 

RTC Real time clock 

VGA Video graphics array 

VLSI Very large scale integration 
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Chapter 7 
The CBIOS 


Overview 


What is the PS/2 BIOS? 


The ROM BIOS contained in Micro Channel Architecture—based IBM PS/2 and 
compatible computers performs the same function that all basic input/ 
output systems do: it isolates the operating system and application pro- 
grams from direct manipulation of the hardware. 


When compared with the ROM BIOS contained in IBM PC XT/AT and compat- 
ible computers, however, the PS/2 ROM BIOS has one critical difference — 
it is designed to support two kinds of operating systems. The PS/2 ROM 
BIOS is divided into two discrete parts: the Advanced BIOS (ABIOS) and 

the Compatibility BIOS (CBIOS). 


The CBIOS 


The CBIOS portion of the PS/2 ROM BIOS provides IBM PS/2 and compatible 
computers backward compatibility with single-tasking, Intel 80x86 real ad- 
dress mode operating systems such as PC- or MS-DOS. As a result, the 
CBiOS consists of a superset of the services and functions available in the 
IBM PC/XT/AT ROM BIOS, and it interfaces with the operating system in the 
same well understood way. 


continued 
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Overview, Continued 


The ABIOS 


The ABIOS portion of the PS/2 ROM BIOS provides IBM PS/2 and compatible 
computers with “forward” compatibility with multitasking, bimodal (real 
mode, protected mode, or both) operating systems, such as IBM OS/2. The 
ABIOS supports the same hardware devices that are supported by the 
CBIOS, but its interface and data structures are specifically constructed to 
facilitate the multitasking, bimodal nature of its design. 


For more information on the ABIOS 


For a complete treatment of the ABIOS, see AB/OS for IBM PS/2 Computers 
and Compatibles in this series. 


In this chapter 


This chapter presents a general introduction to the major concepts and 
design features of the CBIOS. 

The following topics are discussed: 

=» CBIOS Compatibility 

=» CBIOS Memory Usage 

» Interrupts 

CBIOS Software Interrupt Handlers 

» Summary: The CBIOS Services 
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CBIOS Compatibility 


Introduction 


In addition to those BIOS routines responsible for testing/initializing system 
hardware, all BIOSs are essentially made up of a group of ROM-based 
input/output device services. Each of these routines services one subsystem 
of system hardware. Individual BIOS routines service the display, diskette 
drives, fixed disk drives, the keyboard, and so on. 


Operating systems and applications programs written to the BIOS device 
service routines instead of directly to hardware I/O ports and control words 
are assured a high degree of hardware independence. 


CBIOS, BIOS, and application program compatibility 


The CBIOS contains a superset of the service routines contained in all ver- 
sions of the ROM BIOS written for PC/AT-compatible computers. 


Because of this, the CBIOS ensures that operating systems (e.g. MS-DOS) 
and applications programs written to these older BIOS versions will be com- 
patible with the newer IBM PS/2-compatible MCA-based hardware. 


CBIOS and PS/2 


Besides service routines contained in previous IBM-compatible BlOSs, the 
CBIOS also contains all the added functionality required of the single-tasking 
component of the IBM PS/2 MCA-compatible BIOS. 


The CBIOS device service routines support: 

# All IBM VGA video modes and video functions 

= Color and monochrome direct drive analog monitors 
» A “mouse” or other pointing device 

#® Any of 32 IBM-defined fixed disk types 

=» 360K and 1.2 MB 5.25-inch diskette drives 

» 720K and 1.44 MB 3.5-inch diskette drives 

» Micro Channel Architecture-compatible adapter boards 
» All PS/2-compatible system board components 

» Programmable Option Select 

» Password 

» Reference Diskette 
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CBIOS Memory Usage 


Introduction 


Although the CBIOS routines reside in system Read-Only Memory (ROM), 
they also make use of information stored in CMOS RAM and System RAM. 


The illustration on the following page outlines the location and use of CBIOS 
ROM, System RAM, and CMOS RAM. 


continued 
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CBIOS Memory Usage, Continued 


ROM BIOS DATA 

The CBIOS contains routines that test and initialize system hardware 
and boot the operating system. It also contains routines that service the 
microprocessor, the fixed disk, keyboard, display, and other peripheral 
devices with which the microprocessor must communicate. Each of the 
routines is stored in system Read-Only Memory (ROM). The CBIOS 
(and the ABIOS) are stored at address E0000h to FFFFFh in ROM. 


SYSTEM RAM DATA 

The CBIOS uses system RAM to store data that It needs to reference 
or update in the course of executing its device service routines. The 
CBIOS also uses system RAM to store the interrupt vectors. 


» Interrupt Vector Table — An interrupt vector is the segment: offset 
address of a routine Invoked by issuing the assembly language “INT” 
mnemonic. Interrupt vectors are stored in a “Table of Interrupt 
Vectors” in low memory beginning at 00:00h and ending at 00:3FFh. 
The CBIOS initializes those table entries that are reserved for BIOS 
use during POST. Each entry points to one ROM BIOS service 
routine. Other interrupt vector table entries are reserved for use by 
the operating system, the microprocessor, and by end users. 


» BIOS Data Area — At POST, the CBIOS stores a set of data 
definitions in system RAM in absolute memory location 400h-500h. In 
the process of executing device service routines, the CBIOS refers 
to and updates this data. For example, the CBIOS updates 40:50h, 
the location of the cursor on the video page, each time the CBIOS 
routine “Set Cursor Position” is executed. 


» Extended BIOS Data Area — The CBIOS uses the top 1K of system 
RAM to store additional data. The segment of this extended BIOS 
data area is located at 40:0Eh in the standard BIOS Data Area. The 
data located in this area is concerned with the functions that are 
CBIOS enhancements over the historical PC XT/AT BIOSs. For 
example, data definitions concerned with the “mouse” or other 
pointing devices are stored in the extended BIOS Data Area. 


CMOS RAM DATA 

The CBIOS uses nonvolatile CMOS RAM to store real time clock, 
system configuration, and system diagnostic information. Depending on 
the system configuration, the CBIOS can use up to two CMOS RAM 
storage areas. 


= CMOS Data Area — 64 bytes (32 Words) of time-of-day and 
configuration data are located on the system real time clock chip. All 
implementations of the CBIOS make use of this information. 


| = Extended CMOS Data Area — On systems that incorporate more 
than four adapter slots, the CBIOS requires an additional 2K of 
CMOS RAM storage. This area is mainly used for configuration 
information associated with the additional adapter slots. 


continued 
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CBIOS Memory Usage, Continued 


For more information 
To get more information on: 


=» System RAM Data, turn to Chapter 3 of this volume. 
=» CMOS RAM Data, turn to Chapter 4 of this volume. 


Interrupts 


introduction 


Computer systems based on the Intel 80x86 microprocessors are controlled 
mainly through the use of interrupts. Interrupts can be generated by the 
microprocessor, by system hardware, or by software. 


When an interrupt occurs, control of the computer is transferred to an 
interrupt handling routine. Once the routine has executed, the processor's 
- program counter and flag register are returned to their previous state. 


Interrupt numbers 


Every interrupt is assigned its own unique interrupt number, ranging from 
OOh to FFh. : 


By convention, certain ranges of interrupt numbers are reserved for special 
use. The interrupts numbers ranging from 20h-3Fh, for example, are re- 
served for DOS. The numbers from 60h-67h and F1h-FFh are reserved for 
user-created interrupt routines. 


Interrupt vectors 


An interrupt vector is the double word, segment:offset address of the routine 
assigned to a given interrupt number. Interrupt vectors are stored in a table 
in memory beginning at address 00:00h. The vector for INT OOh is stored at 
location 00:00h to 00:03h; the address for INT 02h is stored at address 
00:04h to 00:07h, and so forth. 


continued 
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Interrupts, Continued 


How interrupt vectors are initialized 


The CBIOS writes the Interrupt Vector Table to low memory as part of the 
power-on self test (POST) process, and it initializes the vector address of all 
those interrupts concerned with the BIOS. When DOS is booted, it, in turn, 
initializes all those interrupt vectors concerned with DOS. End users must 
take care to initialize the vectors concerned with their own interrupts. 


How interrupts are invoked 


How a given interrupt is invoked depends on what type it is. 


The table below defines the range of interrupt numbers reserved for each 
interrupt type. It also summarizes how the various types of interrupts are 
invoked. 


Processor Microprocessor, or logical, interrupts are invoked by the proces- 
sor as a result of some unusual program result, such as a pro- 
gram attempt to divide by zero. 


» INTs OOh-04h are reserved for the processor. 


Hardware interrupts are invoked by peripheral devices by setting 
their respective Interrupt Request Line (IRQ). Each time a key is 
pressed, for example, the keyboard hardware generates a hard- 
ware interrupt. Hardware interrupts are vectored to Interrupt 
Service Routines (ISR) that generally reside in the BIOS. 


# INTs 08h-OFh and 70h-77h are reserved by the CBIOS. 


There are three exceptions to this rule, however. 


» CBIOS software INTs 1Dh, 1Eh, and 46h do not service a 
particular device, but act instead to return various ROM- 
resident hardware parameter tables. 


INTs 20h-3Fh are reserved for DOS. 


INTs 05h, 10h-1Ah, 1Dh-1Fh, 40h, 41h, 43h, and 46h are 

reserved for the BIOS. . 
User interrupts are a special class of software interrupt. They 
are invoked in the same way as software interrupts are. That is, 
through the INT mnemonic. 


» INTs 60h-67h and INTs Fih-FFh are reserved for user inter- 
rupt routines. 


Software interrupts are invoked via the assembly language “INT” 
mnemonic. Most software interrupts are vectored to device 
service routines (DSR) located in the ROM BIOS or in DOS. 


continued 
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Interrupts, Continued 


Interrupt vector table 
The table below identifies each interrupt by function and type. Where appli- 
cable, it lists the interrupt vector address initialized by the CBIOS at POST. 


Note: Further discussion of interrupts is limited to those interrupts directly 
related to the CBIOS. The column labeled “Ref. Chapter” tells where 
to turn for a full description of these interrupts. , 


| | | | | | Ref. 


| 00h Divide by Zero Logical — 


[ Nonmastabi mverunt (wt | tegeal_| Fezcan | 7 
test [| 
a 


aa 
rn ane 
ane 
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Interrupts, Continued 


Interrupt vector table, cont’d 


en | 
Vector Chap. 
[ie 


5 
User Timer Tick | User | FFFS3h 15 

1 

7 


[10h | video Parameters Tae ———~ 8108 Table | FFORAH 
ren oiskett Parameters Table 8108 Table | FEFC™ 
Taon-arh [Resonedtordos SCY 
[40h | Diskette 8108 Revector _—_—_—*|—Sofiware | Fecean | 
[ain | Fines Disk Parameter Table | 8108 Table | FEAoMm | 
[aan [EGA Default Video Over =i wo Table | 
[aan | video Gravhice characters «| User | 
Tanase [Resones 
[4en__| Fined Disk Parameter Table | 8108 Tabie | FEAOTH 
Tamim [rere TT 
OO 
Taan-sth | Revoned 
[eon-86n | Reserved for User Program mterrmtal User 
[em [umensoner PT 
a 
a 
Camry [Rewved C—C=~iS 
[_FincFrn | Reserved or User Program iterrtal User [| 
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CBIOS Software Interrupt Handlers 


Software DSRs, functions, and parameters 


Most of the CBIOS software interrupt handlers are capable of executing more 
than one device related routine, or function. 


Individual functions within a given software interrupt handler are identified by 
a hex number, and they are selected by specifying that number in the AH 
register when the interrupt is invoked. 


Note: Some software DSRs also contain subfunctions. Subfunctions are 
usually selected via the AL or the BL register. 


Parameter passing 


10 


In addition to function numbers, all other parameters are passed to and from 
the CBIOS routines via the microprocessor registers. All CBIOS software 
interrupt handlers save the program counter registers, the flag register, and 
all other registers except the AX register and those registers that return a 
value to the caller. 


continued © 
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CBIOS Software Interrupt Handlers, Continued 


How functions are described 


Throughout this manual, the functions performed by the CBIOS software 
interrupt handlers are described in terms of their input and output parame- 
ters. The sample description below is excerpted from Chapter 9, which 
describes the CBIOS Video Service functions. 


Example of a function description 


\ 


Function: AH = 02h Set Cursor Position 


Description 


The Set Cursor Position function sets the cursor position (in terms of 
row-by-—column coordinates) for the display page indicated in BL. It 
saves the position as a two-byte row—by-—coiumn tabie entry in the 
cursor coordinates byte at 40:50n. Row and column coordinates are 
indicated in registers DH and DL respectively. 


The Set Cursor Position function applies to both text and graphics video 
modes. In text modes, if the display page selected in BH is the active 
display page, the on-screen cursor will move to the coordinates 
indicated in registers DH and DL. In graphics modes, the cursor is invis- 
ible, but it is used to define a position on the screen. 


Input/output 
Input: AH = 02h 
BH = Display page number (see function AH = 05h) 
DH = Row (0 is top row of screen) 
DL = Column (0 is leftmost column) 
Output: AX = OOh 
continued 
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CBIOS Software Interrupt Handlers, Continued 


Example program 


This assembly language program uses INT 10h Video Service function 
AH = 02h Set Cursor Position to move the cursor on video page 0 to row 3, 


column 14. 

MOV AH, 2 ‘Select "Set Cursor Position" function 
MOV DH, 3 ‘Input row parameter into DH register 
MOV DL, 14 ‘Input column parameter into DL register 


INT 10H ‘Invoke INT 10h, CBIOS Video Service 
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Summary: The CBIOS Services 


Introduction 


Each CBIOS service executes at least one function. When a given CBIOS 

service is capable of executing more than one function, functions are se- 
lected by placing the proper function number in the AH register. Subfunc- 
tions are selected via either the AL register or the BL register. 


The tables below briefly define each CBIOS service and list each CBIOS 
function and subfunction. 


H The CBIOS Print Screen Service prints the 
et Ss a contents of the current video screen to printer 
ervi number 0. 


PARAMETER | FUNCTION 


05h | None Print Screen 


The CBIOS Video Service provides I/O support for 


Video both color and monochrome analog monitors. 
Service They allow the display of all 17 IBM PS/2 video 
modes. 


PARAMETER | FUNCTION 


Write Attribute/Character at Current Cursor Position 
continued 
The CBIOS 13 


Summary: The CBIOS Services, Continued 


Introduction, cont’d 


Video The CBIOS Video Service provides !/O support for 
| both color and monochrome analog monitors. 


Service, They allow the display of all 17 IBM PS/2 video 
cont’d modes. 


| iNT | PARAMETER | FUNCTION 


SET PALETTE REGISTERS: 


[Parameter [ Subtunction 


AL = 00h Set individual palette register 

AL = Oth Set overscan register 

AL = 02h Set all palette registers and overscan 
AL = 03h Toggle intensify/blinking bit 

AL = 04h-06h | Reserved 

AL = 07h Read individual palette register 

AL = 08h Read overscan register 


14 


AL = 09h 


AL = 10h 
AL = 11h 
AL = 12h 
AL = 13h 


AL = 14h 
AL = 15h 
AL = 16h 
AL = 17h 


AL = 18h-19h 


AL = 1Ah 
AL = 1Bh 


Read ail palette registers and 
overscan 


Set Individual color register 
Reserved 
Set block of color registers 


Select color page (not valid for 
mode 13h) 


BL = 00h Select paging mode 
BL = Oth Select page 


Reserved 

Read individual color register 
Reserved 

Read block of color registers 
Reserved 

Read color paging status 


Sum color values to gray shades 


continued 
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Summary: The CBIOS Services, Continued 


Introduction, cont’d 


Video 


Service 
cont’d 


The CBIOS Video Service provides I/O support for 
both color and monochrome analog monitors. 
They allow the display of all 17 IBM PS/2 video 


PARAMETER | FUNCTION 


10h 
AH = 12h 
The CBIOS 


ALTERNATE SELECT: 


[Parameter | Subtunction 


Return EGA information 
Select alternate print screen routine 
Select scan lines for alphanumeric 


CHARACTER GENERATOR: 


User alpha load 
ROM 8x16 font 


ROM 8x8 double dot font 
Set block specifier (valid in alpha 


modes) 
ROM 8x16 font 


User alpha load (cali after mode 


set) 


ROM 8x14 font (call after mode set) 
ROM 8x8 double dot font (call after 


mode set) 


ROM 8x16 font (call after mode set) 
Set user graphics characters 


pointer at INT 1Fh 


Set user graphics characters 


pointer at INT 43h 
ROM 8x14 font 


ROM 8x8 double dot font 


ROM 8x16 font 
Get font Information 


modes 


Default palette loading during 


set mode 
Video 


Summing to gray shades 


Cursor emulation 
Display switch 
Video screen off/on 


continued 
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Summary: The CBIOS Services, Continued 


Introduction, cont’d 


Video The CBIOS Video Service provides I/O support for 
Service both color and monochrome analog monitors. 
cont’d They allow the display of all 17 IBM PS/2 video 


modes. 


PARAMETER | FUNCTION 


AH = 13h ALTERNATE SELECT: 


AH = 13h READ/WRITE DISPLAY COMBINATION CODE: 


Cursor is moved | 
Cursor not moved (text modes only) 
Cursor is moved (text modes only) 


Cursor not moved 
AL = 00h Read display combination code 
| AL = Oth Write display combination code 
AH = 1Bh Read/Write Display Combination Code | 


AH = 1Ch Save/Restore Video State 


The CBIOS Equipment List Service returns the 
system equipment list, as determined by the 
CBIOS POST routine. 


| INT | PARAMETER | FUNCTION 


continued 


Equipment List 
Service 
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Summary: The CBIOS Services, Continued 


Introduction, cont’d 


The CBIOS Memory Size Service returns the 
amount of available base memory (in Kilobytes), 
as determined by the POST routine. 


PARAMETER | FUNCTION 


The CBIOS Diskette Service performs BlOS-level 
read, write, format, initialization, and diagnostic 
support for up to two internal diskette drives. 


Diskette Note: lf a fixed disk is installed, the CBIOS auto- 

Service matically revectors all 13h Diskette Service 
requests to INT 40h. This revectoring is 
transparent to end users. End users should 
continue to use INT 13h for both fixed disk 
and diskette service requests. 


| INT | PARAMETER | FUNCTION 


"ee 00h Reset Diskette System 
AH = are Read Diskette Status 

AH = | AH = 02h | Read Diskette Sectors 
| AH= 03h 03h Write Diskette Sectors 
AH = 05h Format Diskette Track 


Memory Size 
Service 


an 04h Verify Diskette Sectors 
AH = 06h-07h 


continued 
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Summary: The CBIOS Services, Continued 


Introduction, cont’d 


The CBIOS Fixed Disk Service performs BIOS level 
read, write, format, initialization, and diagnostic 
functions for up to two fixed disk drives. 


AH = 06h-07h 


Fixed Disk © 
Service 


Read Drive Parameters | | 
PAH=0ch | Secktooyindr SOSCS~S 
TAH= 00h | Atorate DekSeectSSOSCSC~S~S~S~S 


Tans teh | Read DekTpe 


continued 
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Summary: The CBIOS Services, Continued 


Introduction, cont'd 


Serial The CBIOS Serial Communication Service per- 


Communication forms RS-232-C character I/O for IBM—compatible 
Service serial port adapters. 


The CBIOS System Services is composed of 
several miscellaneous system-level subservices, 
all of which are invoked via the INT 15h 
mnemonic. 


AH = O6h - | AH = 06h - 20h, | Reserved sss 


AH = 21th POWER-ON SELF TEST ERROR LOG: 


AL = 00h Read POST error log 
AL = Oth Write error code to POST error log 


AH = 80h Device Open 
AH = 8th Device Close 


continued 


System 
Services 
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Summary: The CBIOS Services, Continued 


introduction, cont’d 


System The CBIOS System Services is composed of 
Services several miscellaneous system-level subservices, 
cago all of which are invoked via the INT 15h 
cont'd mnemonic. 


POINTING DEVICE INTERFACE 


} [[rarametor | subtunetion 


Enable/Disable pointing device 
Reset pointing device 

Set sample rate 

Set resolution 

Read device type 

Pointing device initialization 


Extended commands 

BH = 00h Return status 

BH = Oth Set scaling to 1:1 
BH = 02h Set scaling to 2:1 


Device driver far call 


continued 
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Summary: The CBIOS Services, Continued 


Introduction, cont’d 


The CBIOS System Services is composed of 
several miscellaneous system-level subservices, 
all of which are invoked via the INT 15h 
mnemonic. | 


PARAMETER | FUNCTION 


15h AH = C3h ENABLE/DISABLE WATCHDOG TIME-OUT 


[Parameter | Subtunction 
AL = 00h Disable watchdog time-out 
AL = Oth Enable watchdog time-out 


PROGRAMMABLE OPTION SELECT 


[Parameter | Subtunction 
AL = 00h | Enable cursor for setup 
AL = Oth Adapter enable 


Reserved 


System 
Services, 
cont’d 


AH = C5h-FFh 


The CBIOS Keyboard Service interfaces the 
operating system and application programs with 
the keyboard. 


Keyboard 
Service 


AH = 012h Return Extended Shift Flags 


continued 
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Summary: The CBIOS Services, Continued 


Introduction, cont’d 


Parallel Printer The CBIOS Printer Service provides I/O support for 
Service parallel printer ports. 


oe PARAMETER | FUNCTION 


a O3h-FFh Reserved 


AH = 00h Print Character 
| AH=01h | Oth Initialize Printer 
oe 02h Read Status 


The CBIOS Time-of-—Day Service contains func- 
tions that support and maintain the time-—of-—day 
portion of the Motorola MC 146818A (or 
equivalent) CMOS clock chip. 


PARAMETER | FUNCTION | 
1Ah AH = 00h Read System Timer Counter ! 
AH = Oth Set System Timer Counter 


Time-of-Day 
Service 
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Chapter 2 
Hardware Environment 


Overview 


Introduction 
This chapter describes the hardware environment supported by the CBIOS. 


Note: The hardware environment described here also applies to the ABIOS 
portion of PS/2-—compatible ROM BIOSs. 


Hardware overview only 


The hardware contained in IBM PS/2 and compatible systems provides the 
user with a rich and powerful computing environment. A precise description 
of each IBM PS/2 hardware component, however, is beyond the scope of 
this book. The material presented here is intended to give CBIOS users a 
general survey of the PS/2 hardware and is not intended to substitute for 
the hardware data sheet or documentation available from individual hardware 
manufacturers. 


continued 
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Overview, Continued 


CBIOS benefits 


By its very nature, the CBIOS is designed to isolate the user from direct 
manipulation of hardware I/O ports, registers, and control words. As such, 
the CBIOS provides a high level interface to hardware that is guaranteed to 
remain the same when hardware components change. 


This has a number of benefits: 


= If programs use CBIOS calls instead of reads and writes to hardware, they 


will be more portable across differing hardware environments. 


» Using the CBIOS services spares the programmer from having to master 


many details about hardware that may change. 


Additional information 


Two appendices are included in this reference with additional hardware 
information. 


Appendix B — provides a detailed look at the 8042 controller chip. 


Appendix C — describes the Model 25/30 and compatibles hardware 
environment. 


In this chapter 
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The following hardware information is presented: 


80286/80386/80386SX Microprocessors 
Math Coprocessors 

Micro Channel 

1/O Devices 

System Time—Related Devices 

CMOS RAM Service 

DMA Controller 

Programmable Option Select (POS) 
Intel 8259A Programmable Interrupt Controllers 
System Control Port Definitions 
Power-On Password 

NMI Mask 

Hardware |/O Port List 
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80286/80386/80386SX Microprocessors 


Introduction 


The CBIOS must be implemented in systems that employ the Intel 80286, 
80386, or 80386SX microprocessor, an equivalent, or a superset. 


The table below lists the CBIOS microprocessor support. 


Processor Speeds 6 to 20 MHz (80286); 6 to 33 MHz (80386 and 80386SX) 
Note: Currently verified range of supported speeds. 


Address Modes | Real and protected address modes 
Note: See “Address mode support” below. 


Address mode support 


The ROM BIOS for IBM PS/2 and compatible systems can be addressed in 
both the real and the protected address modes of the microprocessor. 


This statement holds true for both the CBIOS and the ABIOS portions of the 
ROM BIOS. The difference between the CBIOS and the ABIOS portions of the 
ROM BIOS lies not in the modes under which they can be addressed but in 
the kind of operating systems each is designed to support. 


* The ABIOS is designed specifically to support multitasking operating sys- 
tems (e.g. IBM OS/2) that execute exclusively in the microprocessor’s 
real mode, exclusively in protected mode, or bimodally — switching be- 
tween real and protected modes. 


* CBIOS is primarily designed to support single-tasking operating systems 
(e.g. MS-DOS) that execute exclusively in the microprocessor’s real 
mode. 
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Math Coprocessors 


Introduction 


The CBIOS can be implemented in systems that include an Intel 80287 or 
80387 math coprocessor (80387SX for 80386SX processors) or an equiva- 
lent math coprocessor. 


Description 


The math coprocessor performs high speed arithmetic, logarithmic, and 
trigonometric floating point arithmetic calculations, permitting much speedier 
processing for mathematically intensive processes. 


The math coprocessor works in parallel with the microprocessor, allowing 
both to process instructions separately. See the user manual for the 
coprocessor for details about the extended data types, registers, and 
instructions available with this chip. 


Math coprocessor hardware interface 


The coprocessor operates in an asynchronous mode and can use the same 
clock generator as the microprocessor. It functions as an I/O device and can 
be accessed through I/O ports OOF8h, OOFAh, and OOFCh. 


The coprocessor BUSY signal tells the microprocessor that the coprocessor 
is operating. The WAIT signal means that it is executing, and forces the 
microprocessor to wait until the coprocessor is done. 


The coprocessor can operate in either the real or protected address mode. 
It is in real address mode after a power-on, a reset, or when returning from 
protected address mode. 


The math coprocessor generates an error signal which sets IRQ 13, and the 
BUSY signal from the coprocessor is then held in the BUSY state. The BUSY 
signal can be cleared by an I/O Write to I/O port OOFOh or by a write of zero 


to I/O port address OOFOh with bits 0-7 set to zeros, which also clears 
IRQ 13. 


continued 
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Math Coprocessors, Continued 


CBIOS: INT 75h Numeric exception error handling 


IRQ 13 (which is generated by a math coprocessor numeric exception error) 
is vectored to INT 75h hardware interrupt service routine as part of the 
CBIOS initialization. When IRQ 13 goes high, INT 75h clears the BUSY signal 
and issues a software interrupt, INT 02h. 


Note: User programs which enable numeric exceptions must provide a 
method for intercepting and processing either INT 75h or INT O2h. 


Micro Channel 


Introduction 


The CBIOS supports such IBM Micro Channel-—compatible features as Pro- 
grammable Option Select (POS) and configurabie Direct Memory Access 
(DMA) arbitration levels. 


The following table lists the Micro Channel hardware supported by the CBIOS: 


Feature Description 

1/O address width is 8-bit Allows either 8-bit or 16-bit I/O transfers. 

or 16-bits. 

nll arbitration control Arbitrates among as many as 15 devices. 

point. 

8 DMA channels. Serial DMA protocol for 8 channels; either 8-bit or 16-bit 
DMA transfer. 

Level-sensitive interrupts. Interrupt controller operated in level-triggered mode to 
allow devices to share interrupt levels. 

Programmable option Eliminates need for jumpers and configuration switches. 

selec 

Channel extension Support future growth and additional channel features. 

connectors 


No support for PC-type Supports only adapters designed for the Micro Channel. 
adapters. 


continued 
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Micro Channel, Continued 


Micro Channel connectors 
The CBIOS supports three types of channel connectors: 
=» 16-bit, made up of an 8—-bit section, and a 16-bit extension, 
# 16-bit with auxiliary video extensions, and 
a 32-bit connectors in Intel 80386-based systems. 


Programmable option select (POS) 


POS data is accumulated in adapter description files (ADFs) which are cre- 
ated by adapter manufacturers for each adapter. The reference diskette 
supplied with MCA-compatible systems reads .ADF files and stores configu- 
ration information in CMOS RAM. The CBIOS power-on self test (POST) 
reads CMOS RAM and writes the configuration information to the POS regis- 
ters of the adapters. 


The POS I/O addresses are 0094h — 0097h and 0100h — 0107h. 
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I/O Devices: Introduction 


The CBIOS supports the following !/O devices: 

» a diskette controller, 

= a fixed disk controller, 

# a VGA video controller, 

= an Intel 8042/8242 or equivalent keyboard controller, 
= a serial port, and 

= a parallel port. 


Each of these capabilities is discussed below. 


I/O Devices: Diskette and Disk Hardware 


Diskette controller 
The CBIOS supports an NEC 765 or equivalent diskette controller. Four types 
of diskette drives are supported: 
® 720K 3.5—inch, 
=» 1.44 MB 3.5-inch, 
» 360K 5.25-inch, and 
» 1.2 MB 5.25-inch drives. 


Diskette drive configuration 


The ROM BIOS supports a maximum of two diskette drives. 


Fixed disk controller 


The ROM BIOS supports up to two fixed disks. The CBIOS supports an 

_ ST506 fixed disk adapter or equivalent. This adapter should be PS/2-compat- 
ible. The ST506 adapter is single-tasking and must complete one operation 
before starting another, even though the next operation may be for the other 
fixed disk. The hardware interrupt request for fixed disk is 14. 


RLL and ESDI fixed disk controllers are also supported by the CBIOS. 


Hardware Environment 
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I/O Devices: Video Hardware 


Introduction | , 
The CBIOS video service supports IBM VGA-compatible hardware, including: 
» a VGA-compatible chip or chip set that includes a: 
= CRT Controller 
» Sequencer 
Graphics Controller, and 
Attribute Controller 
» DAC chip — INMOS G171 or compatible Digital-to—Analog Converter 
» Video RAM — 256K of dynamic read/write RAM configured as four 64K 
maps 
» Monochrome or color direct drive analog monitor 
» Monochrome or color multiple sync frequency monitors 


VGA-compatible chip (or chip set) 


The VGA chip (or chip set) provides all CRT control signals. It Consists of 
four components: CRT Controller, Sequencer, Graphics Controller, and 
Attribute Controller. 


The function of each VGA component is summarized in the table below. 


Function CRT Controlier 
CRT Controller Generates horizontal and vertical CRT sync timings, cursor 
and underline timings, video buffer addressing, and refresh 
addressing. 


Sequencer Arbitrates system access to display RAM and fonts. The 
sequencer allows up to eight fonts with two fonts displayable 
at any one time. 

Graphics Controller Handles read/write operation on 4 parallel bit planes. Outputs 
data to Attribute Controller. 


Attribute Controller Converts incoming text mode attribute data or graphics 
mode pixel data into 8-bit indices into the Digital-to-Analog 
Converter (DAC) color registers (see below). 


Note: For a complete description of VGA-compatible components, I/O 
ports, and registers, refer to the hardware documentation accompa- 
nying your particular VGA-compatible chip or chip set. 


continued 
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I/O Devices: Video Hardware, Continued 


DAC 


The video DAC contains 256 individual color registers which can be accessed 
by the BIOS as either four 64-color registers or sixteen 16-color registers. 


Each DAC color register contains one 18-bit RGB analog value. Six bits of 
each register are allocated to each primary color. Thus, the color repre- 
sented in each DAC color register may be any of 256K possible colors 
(i.e. 29*6 = 256K). 


Video RAM 


The ROM BIOS Video Services require 256K of read/write video RAM format- 
ted into four banks (or maps) of 64K. 


To maintain compatibility, display memory for each of the historical MDA, 
CGA, and EGA-compatible modes is mapped exactly as it was in the original 
display adapter. The display memory organization for the new VGA modes is 
outlined in the CBIOS Video Services chapter. 


Analog monitor support 


To display all modes, the Video Service requires either a monochrome or a 
color direct drive analog monitor with a 31.5 KHz horizontal scan frequency. 


The display’s vertical gain is adjusted automatically by the VGA-compatible 
circuitry. Thus, video modes with 350, 400, and 480 horizontal scan lines 
can be displayed without requiring manual adjustment. 


Multiscan monitor support 


In addition to 31.5 KHz direct drive analog monitors, the Video Service also 
supports multiscan rate monitors capable of operating in analog modes (e.g. 
NEC Multisync monitor). Monitors of this type require an adapter cable that 
matches the signal assignments and monitor ID circuitry of the DAC external 
video controller. 
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I/O Devices: Keyboard Hardware 


Introduction 


The CBIOS supports an intelligent keyboard subsystem based on the Intel 
8042 or equivalent keyboard controller. 


The hardware interrupt level associated with the CBIOS Keyboard Service is 
IRQ 1. 


The 8042 controller chip 


The Intel 8042 peripheral controller (or compatible) is a single chip micro- 
computer that can be programmed to allow bidirectional communication 
between the master microprocessor and up to two auxiliary serial input 
devices. The 8042 chip, generally, is mounted on the system motherboard. 
8042 programs reside as firmware in the 8042 chip itself. 


Device support 


The kind of devices a given 8042 chip supports are dependent on how the 
8042 is programmed. 


On IBM PS/2-compatible systems, the 8042 is programmed to allow bi- 
directional communication between the system and the keyboard, as well 
as between the system and one other auxiliary serial device, such as a 
mouse, joystick, or trackball. 


Pointing device interface 


The pointing device in PS/2-—compatible systems is controlled by the 8042. 
INT 74h handles interrupts from the pointing device. The INT 15h Pointing 
Device Service controls the device operations. 


Reference 


For more information on the 8042 Keyboard Controller Chip, refer to Ap- 
pendix B. 
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I/O Devices: Parallel Port Hardware 


Introduction 


The CBIOS Parallel Port Service is associated with hardware interrupt request 
7. The CBIOS supports a parallel port that can transfer eight bits of data at | 
standard TTL levels. The parallel port can be called port 1 through 8, must 
be IBM PS/2-compatible, and must have a bidirectional mode, supporting 
both input and output. The parallel port also supports level—sensitive inter- 
rupts and a readable interrupt pending status. 


Parallel port addresses» 


The following table lists the most common parallel port addresses. Up to 8 
parallel ports are supported. 


Parallel 
Port Number Data Address Status Address Control Address 


0378h 0379h 037Ah 


Parallel port extended mode 


The extended mode of the parallel port can be selected through the port 
system-based POS registers. The extended mode adds a bidirectional 
interface. 
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/O Devices: Serial Port Hardware 


Introduction 


The CBIOS supports a National Semiconductor 16550 serial port controller or 
equivalent logic. The serial ports can be addressed as Serial 1-8. See the 
equipment list at 40:10h to find out how many serial ports are available. 


Serial 1 and 3 interrupts are on IRQ 4; Serial 2 and 4 interrupts are on 
IRQ 3. 


Serial port addresses/interrupt levels 


The serial port addresses and interrupt levels are listed in the table below. 


NS 16550 characteristics 


The NS 16550, which is functionally compatible with the NS 16450 and the 
NS 8250, supports: 


» Characters of 5, 6, 7, or 8 bits, 
= 1, 1.5, or 2 stop bits, and 
=» even, odd, or no parity modes. 


continued 
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/O Devices: Serial Port Hardware, Continued 


NS 16550 Serial Communications Controller 


The NS 16550 does serial—to—parallel conversions on data received from a 
peripheral device or a modem, and parallel-to-serial conversion on data 
received from the system processor. The system processor can read the 
status of the NS 16550 at any time during its operation. The information 
furnished includes the type and condition of transfer operations in progress, 
as well as any error conditions (parity, overrun, framing, or break interrupt) 
present. The NS 16550 provides complete modem control, and has a user 
programmable processor-interrupt system. 


NS 16550 Serial Controller Registers 
The NS 16550 has 12 accessible registers: 
» Receiver Buffer Register (Read Only) 
»® Transmitter Holding Register (Write Only) 
» Interrupt Enable Register (Read/Write) 
« Interrupt Identification Register (Read Only) 
» FIFO (First in/First out) Control Register (Write Only) 
=» Line Control Register (Read/Write) 
= Modem Control Register (Read/Write) 
=» Line Status Register (Read Only) 
» Modem Status Register (Read Only) 
= Scratch Register (Read/Write) 
«= Divisor Latch (LSB) (Read/Write) 
=» Divisor Latch (MSB) (Read/Write) 


Information on the operation of these registers is contained in the National 
Semiconductor NS 16550 Data Sheet. However, to avoid any incompatibility 
problems introduced by direct hardware programming, use the access to the 
serial controller provided through the BIOS services. 


Programmable baud rate generator 
The serial port controller can operate at speeds of from 110 to 19,200 bps. 
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System Time-Related Devices: Introduction 


System time-related components 


The CBIOS supports that the following time—-handling chips, or their 
equivalents: 


» Intel 82284 Clock Generator 


2 Intel 8254A Programmable Interval Timer (PIT) 
= Motorola MC146818A Real Time Clock 


System Time-Related Devices: 82284 Ciock Generator 


Description 


The Intel 82284 (or compatible) Clock Generator chip interfaces directly to 
the system microprocessor (CPU). The 82284 chip: 


=» Provides the CPU with two clock inputs 
» Generates the READY input to the CPU 


» Synchronizes the system RESET input to the CPU. | 
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System Time-Related Devices: 8254A PIT Chip 


Introduction 


The 8254A Programmable Interval Timer (PIT) is a counter and timer that ! 
provides three channel timers. All channels are driven by a 1.19 MHz oscilla- | 
tor signal. Each “tick” of the PIT generates hardware interrupt request 0. 


The BIOS supports the Intel 8254A programmable counter chip or its equiva- | 
lent. The timer chip need not include a timer/counter 1 but should provide a 
limited—-function timer/counter 3. 


Timer channel differences 


There are some differences between the three timer channels. 


Counters O and 2: 

= are independent 16-bit counters, 

= can be preset, and 

*® can count in BCD (binary coded decimal) or in binary. 


Counter 3: 

= is only 8 bits, 

= can be preset, 

=» counts in binary only, and 
= can only count downward. 


System Timer Modes 


The system timer has six modes: 


sr Ware 


Software Triggered Strobe 
Hardware Retriggerable Strobe 


continued 
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System Time-Related Devices: 8254A PIT Chip, Continued 


Common timer mode operations 
All modes have the following operations in common: 
= All control logic resets when control bytes are written to a counter. 
= Counters do not stop when they reach zero. 


=» In Modes 0, 1, 4, and 5 the counter wraps to the highest possible count, 
and continues to count. 


» In Modes 2 and 3, the counter reloads the initial count and continues to 
count. 


Timer Channels 


The following table describes the functions of the timer channels. The sys- 
tem timer is treated as a series of I/O ports. Three are count registers, and 
two are control registers. | 


| Read/Write 
Channel 1/O Port Status 
0 System Timer 0040h 


[2 Tone Generation fr Speaker | _ooaan «SR 


Control Register 3 | 0047h 


Watchdog Timer 


The Watchdog Timer is used to find out if IRQ 0 is not being serviced, which 
can be used to detect a user program in a tight loop. 


The Watchdog Timer is enabled or disabled by the CBIOS INT 15h, System 
Services, function C3h. 
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System Time-Related Devices: MC146818A RTC Chip 


Introduction 


The BIOS supports a Motorola MC146818A Real Time Clock, or equivalent. 
This chip is assumed to have at least 64 bytes of nonvolatile CMOS RAM : 
available to store configuration data. | 


RTC CMOS RAM Addresses 
The following table lists the CMOS RAM addresses: 


1/O Address Description 
0070h 1 Byte CMOS RAM address, where: 
Bit 7 = 1 NMI disabled 
Bits 6-0 = 0 CMOS RAM address 


0071h CMOS RAM data port 


# To write to CMOS RAM: 
# Inhibit interrupts. 


» Write the CMOS RAM address to which the data is to be written to I/O 
port 0070h. 


=» Write the data to be written to I/O port 007th. 


= To read from CMOS RAM: 
# Inhibit interrupts. 


» Write the CMOS RAM address from which the data is to be read to I/O 
Port 0070h. 


» Read from 1/O port 007th. 


Hardware Environment 39 


CMOS RAM Service 


introduction 


Information may be stored in up to two areas of CMOS RAM. The table 
below describes the CMOS RAM areas available to the ROM BIOS. 


Table of CMOS RAM areas 


0 


CMOS RAM 0070h and 64 bytes “These bytes are located on the Motorola 
Data Area 0071h MC146818A Real Time Clock CMOS RAM 
} chip (or its equivalent). All implementa- 
tions of the BIOS make use of this area 
to store real time clock, POST, and sys- 
tem configuration data. 


Extended _ 0074h, 0075h, When implemented on systems that em- 

CMOS RAM and 0076h ploy more than four adapter slots, the 

Data Area BIOS requires an additional 2K of CMOS 
RAM. This extended CMOS RAM is pri- 
marily used to store POS data. 
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DMA Controller 


DMA functionality 


The hardware environment for DMA transfers is described here in order to 
explain the background against which the DMA CBIOS functions operate. The 
CBIOS, however, serves as a shield between underlying hardware and re- 
quests of the operating system, obviating the need for the caller to directly 
access the DMA controller. 


Direct Memory Access (DMA) allows large amounts of data to be transferred 
from a physical device to system memory or vice versa without micropro- 
cessor involvement. A program may initiate a DMA transfer and have no 
need to copy each byte or word individually, freeing the processor for more 
complex tasks. DMA transfers are typically from/to a fixed I/O port address 
to/from a continually incremented memory address. 


DMA functionality in Micro Channel systems is a superset of the functionality 
of two Intel 8237 DMA Controllers, one addressed at every port, starting with 
Port 0000h, and one addressed at every other port, starting at port OOCOh. 
Access to 8237-compatible DMA functions and to additional functions for all 
channels is provided at I/O ports 0018h and 001Ah. Data output to port 
0018h selects the channel and function, and data output to or input from 
001Ah goes to or from the selected internal register. 


Bus sharing 


The system microprocessor and any currently-transferring DMA users can 
share the bus by taking turns directing bus cycles (driving the Micro Chan- 
nel’s address lines and certain control signals). An arbitration process deter- 
mines which of these possible bus masters are ready to direct a cycle. 
Competing bus masters (DMA devices) are assigned varying priorities, which 
are weighed during arbitration. Each bus master gets control of the bus for a 
number of cycles as determined by the arbitration process. 


DMA device 


A DMA device (or bus master) is one that enters into arbitration for the 
channel. If it wins, it receives addresses and control signals from the DMA 
controller so it can read or write data. 


continued 
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DMA Controller, Continued 


DMA Controller functions 


A DMA controller is a device which monitors the arbitration process and 
gives addresses and control signals to the device that has won the bus 
through arbitration. The controller does not enter into the arbitration itself. 
PS/2-compatible Micro Channel—based systems provide a DMA controller 
that supports DMA transfers to/from up to eight devices at once. 


DMA hardware registers 


The DMA controller maintains several hardware registers for each DMA 
channel. The key registers are: © 


" a memory address where the next byte or word will be transferred to 
or from 


=» a count of the remaining bytes to transfer ((transfer count) 


« a flag (mode) controlling the transfer direction (to memory or to the 
device), and 


= transfer status flags for each channel (status) 


continued 
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DMA Controller, Continued 


DMA hardware registers 
The DMA Controller has ten sets of registers, summarized below: 


Number of 
Register Registers How Allocated 


1 for Channels 7-4 
1 for Channels 3-0 

Arbus 1 for Channel 4 
1 for Channel 0 


1 for Channel 3-0 


Mode Control Field 


The Mode Control field provides an opportunity for the caller to use the 
Autoinitialization and Programmed I/O (PIO) features of the DMA Controller. 


= Autoinitialization 


Specifies if the DMA Controller will initialize automatically when the transfer 
reaches the terminal count. 


= Programmed 1/O 
Specifies that the I/O address is to be programmed to the DMA Control- 
ler, driving the I/O address on the bus during the DMA cycles. 


continued 
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DMA Controller, Continued 


Transfer Control Bytes 


These fields provide an opportunity for the caller to specify the physical 


address of the memory and I/O fields for CBIOS DMA Service functions 10h, 
11h, and 12h. . 


= Count Control 


Specifies if the physical address is decremented or incremented during 
a transfer. 


= Device Size 
Specifies whether this is an 8—bit or 16-bit transfer. 


DMA controlled by microprocessor 


The microprocessor can address the DMA controller and access the DMA 
registers. The microprocessor can control the DMA modes, transfer ad- 
dresses, transfer counts, channel masks, and page registers. 


Direct DMA Controller access 


Reading directly from or writing directly to any DMA Controller port may cause 
unpredictable results. 


DMA data transfer 
After a DMA device has won the arbitration bus and the DMA controller is 
programmed to service the request, a transfer can take place. 
DMA transfers can be: | 
= single transfer, 


» multiple transfer (burst mode), or 
= read verification. | 


~ continued 
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DMA Controller, Continued 


Burst mode 


Burst mode is a method of DMA transfer that allows a device to remain 
inactive for long periods and then send large amounts of data in a short 
time. Some peripheral devices, e.g. a fixed disk, transfer their data in bursts 
that are frequently separated by long periods of inactivity. Burst mode is a 
way of making these devices more efficient. The device asks to be serviced 
only when it has data to transfer and then does so in large quantities. 


Arbitration levels 


Arbitration is a process through which devices compete for control of the 
Micro Channel on a prioritized basis. Arbitration levels are predefined or 
programmable levels of priority assigned to devices that compete for pos- 
session of the channel. 


Central Arbitration Control is a hardware function that allows intelligent pe- 
ripherals to share and control access to the system. Arbitration is organized 
in levels of priority, and on each level there can be a number of competing 
devices. 


Arbitration Levels are numbered from OOh to OFh. In addition, there are 
Arbitration Levels -1 and -2, which exist only on the system board. Of the 
former set, Arbitration Level OOh has the highest priority; Level OEh has the 
lowest. All arbitration level priorities are assigned sequentially; OOh through 
OEh are the highest through lowest priorities. Level OFh is reserved. 


continued 
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DMA Controller, Continued 


Arbitration levels, cont'd | 
The following table summarizes the arbitration levels: 


Arbitration Levels Primary Assignment 


a 
00 ramnes 
oma Charen 
[0am A Crarnel@ 
[098A hanes 
a 
[060 A crane 
a 
00 served SSC 
08n Reser SSCS 
088 eserves 
en Reserves 


*. These DMA Channels can be programmed to any arbitration level 


LEE REE ETE EIT IE IE I PALE TT BI TEI TE TIE SIE IE DIE ELE TIO LETS ITER OEE IE BESTE TE LE RE LTE REESE DIF DIE IESE SEES TESA ETT ASH IEEE IE SETTLER SEEN EINE TE TO TE STE IPT ETE PELE IEEE IERIE LIE IE TALE EOE EEE EEE ELLE LIES TE IEA 
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DMA Controller, Continued 


DMA channel flags 
Additional channel flags control whether 


= a transfer is to be repeated forever, 


» the memory address is to be decremented or incremented after 
each cycle, 


» the DMA controller maintains I/O address (this is hardwired in most 
devices that use DMA), or 


= a byte or a word is transferred at each cycle. 


Physical and Virtual DMA channels 


DMA channels can be either physical or virtual. A physical channel can only 
have one arbitration level, but a virtual channel can be programmed to own 
any arbitration level not currently assigned to a different channel. Thus, a 
virtual DMA channel can have many arbitration levels. 


Functionally, there is no difference between physical and virtual channels. 
Priority is determined by the arbitration level only, where level OOh is the 
highest priority and level OEh the lowest. 


Virtual DMA Channels and the Arbus register 


The arbitration level assignment for channels 0 and 4 can be programmed 
using the two 4-bit Arbus registers. The Arbus registers permit dynamic 
reassignment of the arbitration ID value by which the DMA controller re- 
sponds to DMA requests for bus arbitration. Channels 0 and 4 can then 
service devices at any arbitration level. 


continued 
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DMA Controller, Continued 


DMA Channels 


The DMA channel I/O addresses are defined in the I/O Port Address section 
later in this chapter. They range from 0000h — OOOFh, 0018h, 001Ah, 0081h 
- OO8Fh, and O0COh — OODEh. 


DMA extended mode 


An extended mode register is available for each programmable DMA channel 
and is used when a DMA channel requests a DMA data transfer. DMA chan- 
nels must match the transfer size of the DMA slave, which is programmed 
by Bit 6 of the extended mode register. DMA read transfers of 16 bits from 
8-—bit memory or 8—bit memory-mapped I/O devices are not supported. 


The following table describes the DMA extended mode register: 


Bit Number | Description 


0 
= 0 8-bit transfer 
= 1 16-bit transfer 


Reserved 


0 
0 Read memory transfer 
1 Write memory transfer 


= 0 Verify 
= 1 Transfer data 


Reserved 
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Programmable Option Select (POS) 


Introduction 


Because it is an integral part of the Micro Channel Architecture (MCA), 
Programmable Option Select support is assumed. 


Adapter slots 


The CBIOS supports up to eight adapter cards (or more on systems with a 
customized BIOS). The CBIOS will work with any system regardless of the 
number of adapter slots available. 


Adapter card identification 
Each adapter card must have a unique 2-byte identifier. 


Adapter description files 


POS data is accumulated in adapter description files (ADFs) that are created 
by adapter manufacturers for each adapter. The reference diskette supplied 
with MCA-compatible systems reads the .ADF files and stores the configura- 
tion information in CMOS RAM. This information is read by the BIOS power- 

on self test (POST), which writes it to the POS registers of the adapters and 
the system board. 
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Intel 8259A Programmable Interrupt Controllers 


Introduction 


The CBIOS supports two cascaded Intel 8259A Programmable Interrupt Con- 
troller (PIC) chips, or their functional equivalent. 


Description 


The PIC handles all maskable hardware interrupts. The CBIOS insures com- 
patibility with hardware interrupts expected by existing software. Formerly 
reserved, IRQ2 is now associated with the 8042 Auxiliary Device (mouse) 
controller. 


Levels of interrupt 


There are 16 levels of interrupts. Interrupts are level—sensitive, allowing 
several devices to share the same hardware interrupt. This reduces the 
interrupt controller’s sensitivity to a transient signal on the Micro Channel 
bus. 


Programmable Interrupt Controller addresses 
The following table lists all PIC addresses: 


a [tt [on ane_[ PE [oc 
Address Equivalents IRQs Routed Status Description 
[20h | master 260 | iaQo-ina7 | AW 
[2m | master e2soa_ | inao-ina7 | Ww _ 


continued 
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Intel 8259A Programmable Interrupt Controllers, Continued 


Table of IRQ assignments 


The following table shows the assignment of interrupt requests to commonly 
interrupting devices, listed from highest to lowest priority. Other devices 

not listed may use interrupt requests and may share requests with these 
devices. 


red tere SSS 
[hat | Keyboarg 
[hae | tha 6-15 are cascaded trough? 
ha | erect cascace 
naan 
a | eserves 
SX 


Pp RQ4 | Serial port 1 


Parallel port 2 


IRQ 7 Parallel port 1 
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System Control Port Definitions 


Introduction 


The CBIOS supports certain system control functions at 1/O Port addresses 
0061h and 0092h. 


Port 61h: System Control Port B 


The read/write definitions for |/O port address 0061h, System Control Port 
B, are: | 


Port 61h: Write Operations 
Description 
= 1 Reset timer 0 output latch (IRQ 0) 


nae ae 
es ane = 0 Enable channel check 


= 0 Enable parity check | 
= 1 Speaker data enable 


= 1 Enable Timer 2 gate to speaker 


anes ae 
| 
SO 
ir 2 tpt 
ee 
a 
i 
——— 
a 


= 0 Channel check enabled 
= 0 Parity check enabled 
= 1 Speaker data enabled 


= 1 Timer 2 gate to speaker enabled 


52 
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System Control Port Definitions, Continued 


Port 92h: System Control Port A 


1/O port 92h (R/W), System Control Port A, contains system control flag 
data. System control Port A is defined below: 


Description 


ee 
so serves (must be wo) 
Ps Watchin te-out cooured 
SS 
a 
ss 
Co 
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Power-On Password 


There are eight bytes in CMOS RAM reserved for a 1-7 byte password and a 
check character for that password. The microprocessor accesses these 
bytes during POST. These bytes cannot be accessed by a user program. 


These eight bytes are initialized to zeros and are changed to the password 
during password installation. Passwords can only be changed during POST 
via the program on the reference diskette which is supplied with MCA- 
compatible systems. 


Models 25 and 30: Power-on password is not supported in IBM PS/2 Models 
25 and 30, and compatibles. For a complete description 
of the Model 25/30 hardware environment turn to Ap- 
pendix C. 


NMI Mask 


The NMI (nonmaskable interrupt) input to the microprocessor is masked off 
at power-on reset. Bit 7 of I/O address 0070h is set to zero to enable the 
NMI. A power-on reset sets this bit to one. 


54 CBIOS for IBM PS/2 Computers and Compatibles 


Hardware 1|/O Port List 


Table: Hardware 1|/O Port Definitions 


Read/Write 
1/O Address Status Description 


[—acotm[ Rw | DMA chant, ranatr count egter 
[secon [Aw [BMA char 1, memory ares register 


0004h DMA channel 2, memory address register 
0005h DMA channel 2, transfer count register 


0006h DMA channel 3, memory address register 
0007h DMA channel 3, transfer count register 


0008h DMA channel 0-3, status register, where: 

Bit 7 Channel 3 request 
Bit 6 Channel 2 request 
Bit 5 Channel 1 request 
Bit 4 Channel 0 request 

Bit 3 Terminal count on channel 3 

| Bit 2 Terminal count on channel 2 

| Bit 1 Terminal count on channel 1 

Bit O Terminal count on channel 0 

0O0Ah _ DMA channel 0-3, mask register, where: 
b Select channel 1 
Ob Select channel 2 


R/W 
Bits 7-3 = 0 Reserved 
000Bh WwW 
1b Select channel 3 


ou dou nb no a 
mek ehh eh eek eek ek ook ok 


Bits 1-0 = 00b Select channel 0 
01b Select channel 1 
10b Select channel 2 
11b Select channel 3 


DMA channel 0-3, mode register, where: 


Bits 7-6 = 00b Demand mode 
01b Signal mode 
10b Block mode 

1b Cascade mode 


Bits 5-4 Reserved 

Bits 3-2 b Verify operation 
b Write operation 
b Reserved 

Bits 1-0 b Select channel 0 


1 

0 

00 

01 

bts Read operation 
00 

01 

1 

1 


Bit 2 = 0 Clear mask Bit 
= 1 Set mask Bit 
000Ch DMA Clear Byte Pointer | 
000Dh DMA Master Clear Byte 


continued 
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Hardware I/O Port List, Continued 


Table: Hardware I/O Port Definitions, cont’d 
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Read/Write 
1/O Address Status Description | 


a DMA Channel 0-3 Clear Mask Register 


DMA channel 0-3, write mask register, where: 


Bits 7-4 = 0 reserved 
| Bit 3 = 0 unmask channel 3 mask bit 
1 set channel 3 mask bit 
Bit 2 0 unmask channel 2 mask bit 
1 set channel 2 mask bit 
Bit 1 unmask channel 1 mask bit 
Bit 0 0 


set channel 1 mask bit 
unmask channel 0 mask bit 
1 set channel 0 mask bit 


DMA extended function register, where: 


Bits 7-4 = Progress command, where: 
00h I/O address register 
Oih Reserved 
02h Memory address register write 
03h Memory address register read 
04h Transfer count register write 
05h Transfer count register read 
O6h Status register read 
07h Mode register 
08h Arbus register 
09h Mask register set single bit 
OAh Mask register reset single bit 
OBh-0Ch Reserved 
ODh Master clear 
OEh-OFh Reserved 

Bits 3-0 = 0 Reserved 


001Ah | RW | DMA extended function execute register 


ey PIC, Interrupt request/In-service registers pro- 


grammed by Operation Command Word 3 
(OCW3): 


Interrupt request register, where: 


Bits 7-O= 0 No active request for the cor- 
responding interrupt line 
= 1 Active request for the correspond- 
ing interrupt line 


Interrupt in-service register, where: 


Bits 7-O0= 0 The corresponding interrupt line is 
not currently being serviced 

= 1 The corresponding interrupt line is 

currently being serviced _— 
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Hardware I/O Port List, Continued 


Table: Hardware I/O Port Definitions, cont’d 


Read/Write 
1/0 Address Status Description 


PIC, Initialization Command Word 1 (ICW1) (Bit | 
4 is one), where: 


Bits 7-5 = 000 Only used in 80/85 mode 


Bit 4 = 1 Reserved 
Bit 3 = 0 Edge triggered mode 
= 1 Level triggered mode 
Bit 2 = 0 Successive interrupt vectors are 


separated by eight bytes 
= 1 Successive interrupt vectors are 
separated by four bytes 


Bit 1 = 0 Cascade mode 
= 1 Single mode — no ICW3 needed 
Bit 0 = 0 No ICW4 needed 


1 ICW4 needed 


PIC, ICW2, ICW3, or ICW4 in sequential order 
after ICW1 written to Port 0020h 


ICW2, where: 


Bits 7-3 = Address lines AO-A3 of base vector 
address for interrupt controller 
| Bits 2-0 = 000 Reserved 


ICW3, where: 
Bits 7-0 = 0 Slave controller not attached to 
corresponding interrupt pin 
= 0 Slave controller attached to 
corresponding interrupt pin 


ICW4, where: 


Bits 7-5 = 000 Reserved 
Bit 4 = 0 No special fully-nested mode 
= 1 Special fully-nested mode 
Bits 3-2 = 00 Non-buffered mode 
| = 01 Non-buffered mode 
= 10 Buffered mode/slave 
= 11 Buffered mode/master 
Bit 1 = 0 Normal EOI! 
| = 1 Auto EOI 
Bit 0 = 0 80/85 mode 
= 1 8086/8088 mode 


PIC, Interrupt mask register (OCW1), where: 
Bit 7 0 Enable parallel printer interrupt 


Bit 6 = Q Enable diskette interrupt 
Bit 5 = 0 Enable fixed disk interrupt 
Bit 4 = 0 Enable serial port 1 interrupt 
Bit 3 = 0 Enable serial port 2 interrupt 
Bit 2 = 0 Enable video interrupt 
Bit 1 = 0 Enable keyboard interrupt 

| Bit 0 = 0 Enable timer interrupt 
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Hardware I/O Port List, Continued 


Table: Hardware I/O Port Definitions, cont’d 
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| Bit 4 


Read/Write 
1/O Address Status Daserbtion 


PIC, OCW2 (Bit 4 is zero, Bit 3 is zero), where: 


Bits 7-5 = 000 Rotate in automatic EOI mode 
(clear) 

001 Non-specific EOI 

010 No operation 

011 Specific EOI 

100 Rotate in automatic EOI mode 


(set 
= 101 Rotate on non-specific EO! 
command 
110 Set priority command 
111 Rotate on specific EOI 
command 
Bit 4 0 Reserved 
Bit 3 0 Reserved 
Bits 2-0 = Interrupt request to which the 
command applies 


PIC, OCW3 (Bit 4 is zero, Bit 3 is one), where: 


Bit 7 = 0 Reserved 
Bits 6-5= 00No operation 
01 No operation 
10 Reset special mask 
11 Set special mask 
0 Reserved 
Bit 3 1 Reserved 
Bit 2 0 No poll command 
1 Poll command 
Bits 1-O= 00No operation 
= 01 No operation 
= 10Read interrupt request register 
on next read at Port 0020h 
= 11 Read interrupt in-service register 
on next read at Port 0020h 


Programmable Interrupt Timer — Read/write 
counter 0 


Programmable Interrupt Timer - Read/write 
counter 2 


continued 
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Hardware 1|/O Port List, Continued 


Table: Hardware !/O Port Definitions, cont'd 


2; where: 


Bit 0 


Bit 7 
Bit 6 
Bit 5 
Bit 4 
Bit 3 
Bit 2 
Bit 1 
Bit 0 


Hardware Environment 


Read/Write 
1/O Address Status Description 


PIT, control word register for counters 0 and 


Bits 7-6 = 00b Select counter 0 
= 01b Reserved 
= 10b Select counter 2 
Bits 5-4 = 00b Counter latch command 
= 01b Read/write counter bits 0-7 


y 
= 10b ne soreane counter bits 8-15 
only 
= 11b Read/write counter bits 0-7 
Bits 3-0 = 000b Mode 0 select 


= 001b Mode 1 select 
= X10b Mode 2 select 


hou we tt 


PIT, read/write counter 3 


PIT, control word register for counter 3, where: 
Bits 7-6 = 00b Select counter 3 


Bits 5-4 = 


System control port B, where: 


onl 
first, then bits 8-15 


X11b Mode 3 select 

100b Mode 4 select 

101b Mode 5 select 

0 Binary counter 16 bits 

1 Binary coded decimal counter 


01b Reserved 


00b Counter latch command 
select counter 0 

= 01b Read/write counter bits 0-7 
only 

10b Reserved 

11b Reserved 


= 1 Parity check 

1 Channel check 

1 Timer 2 output 

1 Toggle with each refresh request 
0 Channel check enabled 

0 Parity check enabled 

1 Speaker data enabled 

1 Timer 2 gate to speaker enabled 
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Hardware 1|/O Port List, Continued 


Table: Hardware !/O Port Definitions, cont’d 


| | Read/Write | | 
I/O Address Status Description 


006 1h W System control port B, where: 
. Bit 7 = 1 Reset timer 0 output latch (IRQ 0) 
, Bits 6-4 = Reserved | 
Bit 3 = 0 Enable channel check 
| | Bit 2 = 0 Enable parity check 
: | Bit 1 = 1 Speaker data enable 
= 1 Enable timer 2 gate to speaker 


8042 Status, where: 


Bit 7 = 1 Parity error 

Bit 6 = 1 General time out 

Bit 5 = 1 Auxiliary output buffer full 
Bit 4 1 Inhibit switch 


Bit 3 = 1 Command/data 
Bit 2 = System flag 
Bit 1 = 1 Input buffer full 


Bit O = 1 Output buffer full 


CMOS RAM address register port, where: 


Bit 7 = 1 NMI disable 
= 0 NMI enabled 
Bits 6-O = 0 CMOS RAM address 


continued 
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Hardware 1/O Port List, Continued 


Table: Hardware 1/O Port Definitions, cont’d 


Read/Write 
1/O Address Status Description | 


DMA arbitration register, where: 


Bit 7 = 1 System microprocessor cycles 
enabled 

Bit 6 = 1 Arbitration mask by NMI 

Bit 5 = 1 Bus timeout 

Bit 4 = 0 Reserved 


Bits 3-0 = Arbitration level 


DMA arbitration register, where: 


Bit 7 = 1 Enable system microprocessor 
cycle 

Bit 6 = 1 Arbitration mask 

Bit 5 = 1 Enable extended arbitration 


Bits 4-0 = 0 Reserved 


DMA card selected feedback register, where: 


Bits 7-1 = Reserved 

Bit 0 = 1 Card selected feedback signal 
active on previous cycle or 
system board |/O functions 

accessed by an 1/O cycle 


System control port A, where: 


Bit 7 = 1 Fixed disk activity light bit A on 
Bit 6 = 1 Fixed disk activity light bit B on 
Bit 5 = X Reserved 

Bit 4 = 1 Watchdog timeout occurred 
Bit 3 = 1 Security lock latch locked 

Bit 2 = X Reserved 

Bit 1 = 1 Alternate gate A20 active 

Bit O = 1 Alternate hot reset 


System board setup enable register, where: 


Bit 7 = 0 Enable system board setup 
= 1 Disable system board setup 

Bit 6 = 1 Reserved 

Bit 5 = 0 Enable VGA setup 


= 1 Disable VGA setup 
Bits 4-0 = 1 Reserved 


POS channel position select register, where: 


Bit 7 = 1 Channel 1 reset 
Bits 6-4 = Reserved (written as 0, read as 1) 
Bit 3 = 1 Channel select 


Bits 2-0 = 0 Channel number 
Programmable Interrupt Controller 2 


continued 
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Hardware /O Port List, Continued 


Table: Hardware 1|/O Port Definitions, cont’d 


| Read/Write 
1/O Address Status Description 


0OAth R/W Programmable Interrupt Controller 2 mask, 
where: 
Bit 7 = 0 Reserved | 
Bit 6 = 0 Enable fixed disk interrupt . 

| Bit 5 = 0 Enable 80387 exception interrupt 
Bit 4 = 0 Enable mouse interrupt 
Bit 3 = 0 Reserved 
Bit 2 = 0 Reserved 
| Bit 1 = 0 Enable redirect cascade 

Bit 0 = 0 Enable real time clock interrupt 


R/W 
R/W 
R/W 
R/W 
R/W 
R/W 


OOCEh R 


[eocen | _AM 
00DOh DMA channel 4-7, status register, where: 
Bit 7 = 1 Channel 7 request . 
Bit 6 = 1 Channel 6 request 
Bit 5 = 1 Channel 5 request 
| Bit 4 = 1 Channel 4 request 
Bit 3 = 1 Terminal count on channel 7 
Bit 2 = 1 Terminal count on channel 6 
Bit 1 = 1 Terminal count on channel 5 
| Bit O = 1 Terminal count on channel 4 
00D4h R/W DMA channel 4-7, mask register, where: 
Bits 7-3 = 0 Reserved 
Bit 2 = 0 Clear mask bit 
= 1 Set mask bit 
Bits 1-0 = 00b Select channel 4 
= 01b Select channel 5 
= 10b Select channel 6 
= 11b Select channel 7 


continued 
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Hardware I/O Port List, Continued 


-2 


0 


0 
0 
1 
1 
0 
0 
1 
1 


0 Reserved 
0 Reserved 
Ob Verify operation 
1b Write operation 
Ob Read operation 
1b Reserved 
0 
1 
Bits 7-4 = 0 Reserved 
Bit 3 = 0 Unmask channel 7 mask bit 
1 Set channel 7 mask bit 
Bit 2 0 Unmask channel 6 mask bit 
1 Set channel 6 mask bit 
Bit 1 ; Unmask channel 5 mask bit 
Bit 0 : 


Table: Hardware I/O Port Definitions, cont’d 
b Select channel 4 
b Select channel 5 
Set channel 5 mask bit 
Unmask channel 4 mask bit 


Read/Write 
1/O Address Status Description 
0ODE6h R/W DMA channel 4-7, Mode Register, where: 
Ob Select channel 6 
1b Select channel 7 
Set channel 4 mask bit 
FO-FFh Math Coprocessor 


Bits 7-6 = 00b Demand mode 
= 01b Single mode 
= 10b Block mode 
00D8h DMA Clear Byte Pointer 
O0DAh DMA Master Clear 
00DCh DMA Channel 4-7, Clear Mask Register 
POS Adapter Identification (least significant 
byte) 
POS Adapter Identification (most significant 


11b Cascade mode 
DMA Channel 4-7, Write Mask Register, where: 
byte) 


oO 
pure 
© 
—_ 
a 
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Hardware I/O Port List, Continued 


Table: Hardware 1|/O Port Definitions, cont’d 


| | Read/Write 
1/O Address Status Description 


POS register 2 for the sister board setup, 
where: 


Bit 7 = 0 Enable parallel port extended 


mode 

= 1 Disable parallel port extended 
mode 

Bits 6, 5 = Parallel port select, where: 

00 Parallel 1 3BC-3BE 

01 Parallel 2 278-37A 

10 Parallel 3 278-27A 

1 Reserved 


Bit 4 Enable parallel port, if bit 0 = 1 
Disable parallel port 
Bit 3 System board serial is serial 1 


1 

1 

0 

1 

0 System board serial is serial 2 
Bit 2 Enable serial port, if bit 1 = 1 
Bit 1 1 
0 
1 


Bit 0 


Disable serial port 

Enable diskette, if bit 0 = 1 
Disable diskette 

Allows bits 4, 2, and 1 to 
enable/disable devices 

= 0 Disables system board devices 


For an adapter card, the following bit is 
defined: 


Bit 0 = 1 Enabie adapter card 


POS register 3, where: 


Bits 7-2 = Reserved 
Bit 1 = 0 Password disabie 
Bit O = Reserved 


Pos register 4 | 


POS register 5 for an adapter card, where: 


of 03h 


0104h_ 


7 i 


Bit 7 = 0 Channel check condition occurred 
= 1 Channel reset 
Bit 6 0 Channel check exception status 
available 


0106h 
0107h 


1F0-1F8h 
200-20Fh 


0278h 


POS subaddress extension (least significant © 
byte) | 
ae extension (most significant 

yte 


Fixed disk | 


Parallel 3, Data Port 
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Hardware I/O Port List, Continued 


Table: Hardware !/O Port Definitions, cont’d 


= 1 Printer is selected 

= 0 Error 

= 0 IRQ has occurred 
Bits 1-0 = Reserved 


Parallel 3, Control Port, where: 


Bits 7-6 = Reserved 
Bit 5 = 0 Direction is write to port 
| = 1 Direction is read from port 
Bit 4 1 Enable IRQ 
Bit 3 1 Select printer 
Bit 2 0 Initialize printer 
| Bit 1 1 Automatic line feed 
Bit 0 1 Strobe 


Serial 2, transmitter holding register, where: 


Bits 7-0 Data bits 7-0, respectively, when 
| Divisor Latch Access Bit = 0 


Serial 2, receiver buffer register, where: 


Bits 7-0 = Data bits 7-0, respectively, when 
DLAB = 0 


Serial 2, divisor latch, low byte, where: 
Bits 7-0 = Bits 7-0 of divisor, when DLAB = 1 


Serial 2, divisor latch, high byte 
Bits 7-0 = Bits 15-8 of divisor, when DLAB = 1 


Serial 2, interrupt enable register, where: 


Bits 7-4 = 0 Reserved 

Bit 3 = 1 Modem status Interrupt enable 

Bit 2 = 1 Receiver line status interrupt 
enable 

Bit 1 = 1 Transmitter holding register 
empty interrupt enable 

Bit 0 = 1 Received data available interrupt 
enable when DLAB = 0 


Serial 2, interrupt identification register, where: 


Bits 7-3 = 0 Reserved 
Bits 2-1 =00b Modem status interrupt 
=O1b Transmitter holding register 
empty interrupt 
= 10b Received data available register 
interrupt 
= 11b Receiver line status interrupt 
Bit 0 = 0 Interrupt pending 
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Hardware I/O Port List, Continued 


Table: Hardware I/O Port Definitions, cont’d 


66 


| 
aa 


- a 


| Read/Write 
I/O Address Status Description 


Serial 2, FIFO control register, where: 


Bits 7-6 = Receiver FIFO register trigger 
0 byte 
O1b = 4 bytes 
10b = 8 bytes 
11b = 14 bytes 
Bits 5-3 = 0 Reserved 
Bit 2 = Transmitter FIFO register reset — 
1 =transmit FIFO register cleared, 
counter cleared, bit is self- 
| clearing 
Bit 1 = Receiver FIFO register reset 
1 = receiver FIFO register cleared, 
counter cleared, bit is self- 
clearing 
Bit 0 = FIFO enable 
1 =receiver and transmitter FIFOs 
enabled, must be 1 to program 
FIFO registers | 
0 =clears receive and transmit 
FIFO registers, enters charac- 
ter mode 


Serial 2, line control register, where: 


Bit 7 = 1 Divisor latch access 
= 0 Receiver buffer, transmitter 
holding, or interrupt enable 
registers access 


Bit 6 = 1 Set break enable 
Bit 5 = Stick parity 

Bit 4 = Even parity select 
Bit 3 = Parity enable 

Bit 2 = Number of stop bits 


Bits 1-0 = 00b Word length is 5 bits 

= 01b Word length is 6 bits 
= 10b Word length is 7 bits 
= 11b Word length is 8 bits 


Serial 2, modem control register, where: 
Bits 7-5 = 0 Reserved 


Bit 4 = 1 Loopback mode 

Bit 3 = 1 Enable OUT2 interrupt 

Bit 2 = 1 Force OUT1 active 

Bit 1 = 1 Force request-to-send active 
Bit 0 = 1 Force data-terminal-ready 


active 
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Hardware 1/O Port List, Continued 


Table: Hardware 1/O Port Definitions, cont’d 


Read/Write 
1/O Address Status Description 


Serial 2, line status register, where: 


Hardware Environment 


Bit 7 
Bit 6 


Bit 5 


Bit 4 
Bit 3 
Bit 2 
Bit 1 
Bit 0 


= 0 Reserved 

= 1 Transmitter shift and holding 
registers empty 

= 1 Transmitter holding register 

empty 

Break interrupt 

Framing error 

Parity error 

Overrun error 

Data ready 


fou ow ued 
wk eek eek ek dk 


Serial 2, modem status register, where: 


Bit 7 
Bit 6 
Bit 5 
Bit 4 
Bit 3 
Bit 2 
Bit 1 
Bit 0 


= 1 Data carrier detect 

1 Ring indicator 

1 Data set ready 

1 Clear to send 

1 Delta to carrier detect 

1 Trailing edge ring indicator 
1 Delta data set ready 
1 Delta clear to send 


‘Serial 2, scratch register | - 
Fixed Disk Adapter Register (8 or 16 bit) 


Fixed Disk Adapter Control Register, where: 


Bit 7 
Bit 6 
Bit 5 


Bit 4-3 


Bit 2 
Bit 1 


Bit 0 


= 1 Reset 

= 1 Reserved (except during reset) 

1 16-bit mode (must match bit 2) 

0 8-bit mode 

0 Reserved 

1 16-bit mode (must match bit 5) 

0 8-bit mode 

1 Enable interrupt through Program- 
mabie Interrupt Controller (hard- 
ware interrupt) 

= 0 enable interrupt through Interrupt 

Status Register (port 324h) 
= 1 DMA mode 
= 0 PIO mode 


Fixed Disk Adapter Status Register, where: 
Bit 7-6 = 0 Reserved 


Bit 5 


Bit 4 
Bit 3 


Bit 2 
Bit 1 
Bit 0 


= 1 16-bit mode 

= 0 8-bit mode 

1 Data transfer requested by adapter 
1 Direction is adapter to system 

0 Direction is system to adapter 

1 Busy 

1 Interrupt request (notification) 

1 Transfer in progress 


continued 
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Hardware 1/O Port List, Continued 


Table: Hardware I/O Port Definitions, cont’d 


| | Read/Write | 
1/O Address | Status Description 


0324h | WwW Fixed Disk Adapter Attention Register, where: 

Bit 7 = 1 Command control block 
Bit 6 = 1 Command specify block 
Bit 5 = 1 Sense summary block ? 
Bit 4 = 1 Data transfer requested by system 

| Bit 3 0 Reserved | 
Bit 2 0 Drive 0 select 

1 drive 1 select 
Bit 1 0 Reserved 
Bit 0 = 1 Abort current command | 

0324h a Fixed Disk Adapter Interrupt Status Register 


where: 
0378h | RW Parallel 2, data port 


Bit 7 = 1 Termination error, bits 0-6 indi- 
cate what the error is 


Bit 6 = 1 Invalid command 
Bit 5 = 1 Command reject 
Bit 4-3 = 0 Reserved 
Bit 2 = 0 Drive 0 selected 
= 1 Drive 1 selected 
Bit 1 = 1 Error recovery procedure invoked 
Bit 0 = 1 Equipment check 


| 0379h Parallel 2, status port, where: 
Bit 7 = 0 Busy 
Bit 6 = 0 Acknowledge 
Bit 5 = 1 Out of paper 
Bit 4 = 1 Printer is selected 
Bit 3 = 0 Error 
i Bit 2 = 0 IRQ has occurred 
Bits 1, 0 = Reserved 


Parallel 2, control port, where: 
Bit 7-6 = Reserved 


Bit 5 = 0 Direction is write to port 

1 Direction is read from port 
Bit 4 1 Enable IRQ 
Bit 3 1 Select printer 


Bit 2 0 Initialize printer 
Bit 1 1 Automatic line feed 
Bit 0 1 Strobe 


03B4h | RW VGA CRT controller index register (mono) 
03B5h | RW Other VGA CRT controller registers (mono) 


O3BAh PR VGA input status register 1 (mono) 
O3BAh VGA feature control register (mono) 
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Hardware I/O Port List, Continued 


Table: Hardware I/O Port Definitions, cont'd 


Read/Write 
1/O Address Status Description 


O03BCh a Parallel 1, data port 


Parallel 1, status port, where: 


Bit 7 = 0 Busy 

Bit 6 = 0 Acknowledge 

Bit 5 = 1 Out of paper 

Bit 4 = 1 Printer is selected 
Bit 3 = 0 Error 

Bit 2 = 0 IRQ has occurred 


Bits 1, 0 = Reserved 


Parallel 1, control port, where: 


Bit 6 = Reserved 
Bit 5 = 0 Direction is write to port 
= 1 Direction is read from port 
Bit 4 = 1 Enable IRQ 
Bit 3 = 1 Select printer 
Bit 2 = 0 Initialize printer 
Bit 1 = 1 Automatic line feed 
Bit 0 = 1 Strob e 


continued 


03COh 
03C1h 
03C2h 
03C2h 
03C3h 
03C4h 
03CSh 
03C6h 
03C7h 
03C7h 
03C8h 
_03C9h 
03CAh 
03CCh 
O3CEh 
03CFh 
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Hardware I/O Port List, Continued 


Table: Hardware 1/O Port Definitions, cont’d 


Read/Write 
1/O Address Status Description 


| osD4n | RW VGA CRT controller index register (color) 
| O3DSh R/W Other VGA CRT controller registers (color) | 
WwW 


O03DAh FR VGA input status register 1 (color) 
O03DAh Fw VGA feature control register (color) 


Diskette controller status register A, where: 


Bit 7 = 1 Interrupt pending 
Bit 6 = 0 Second drive installed 


BitS5 =1 Step 

Bit4 =1 Track 0 

Bit3 = 1Head 1 select 
Bit 2 =0 Index 

Bit 1 = 0 Write protect 


Bit 0 


Diskette controller status register B, where: 


Bit 7-6 = 0 Reserved 

Bit 5 = Drive select 

Bit 4 = Write data 

Bit 3 = Read data 

Bit 2. = Write enable 

Bit 1 = 1 Motor enable 1 
Bit 0 = 1 Motor enable 0 


Diskette controller digital output register, where: 
Bit 7-6 = 0 Reserved 


0 Data received by controller 


0 Allow interrupts 
0 Controller reset 
0 Reserved 
0 


Drive select 0 
Drive select 1 


Diskette controller status register, where: 


Bit 7 = 1 Data register is ready 
Bit6 = 1 Transfer is from controller to 
system 
= 0 Transfer is from system to 
controller 


BitS = 1Non-DMA mode 

Bit 4 =1 Diskette controller busy 
Bit 3-2 = Reserved 

Bit 1 = 1 Drive 1 busy 


Bit 0 0 Drive 0 busy 


continued 


70 CBIOS for IBM PS/2 Computers and Compatibles 


Hardware I/O Port List, Continued 


Table: Hardware !/O Port Definitions, cont’d 


Read/Write 
I/O Address Status Description 


Diskette controller digital input register where: 
Bit 7 = Diskette change 


Bits 6-1 = Reserved 
Bit 0 = 0 High density select 


Diskette controller configuration control 
register, where: 


Bits 7-2 = Reserved 
Bits 1-0 = 00b 500 kbs mode 
= 01b Reserved 

= 10b 250 kbs mode 
= 11b Reserved 


Serial 1, transmitter holding register, where: 
Bits 7-0 = Data bits 7-0, respectively, 
when Divisor Latch Access Bit 

(DLAB) = 0 
Serial 1, receiver buffer register, where: 
Bits 7-0 = Data bits 7-0, respectively, 
when DLAB = 0 

Serial 1, divisor latch, low byte, where: 
Bits 7-0 = Bits 7-0 of divisor, wnen DLAB = 1 


Serial 1, divisor latch, high byte, where: 
Bits 7-0 = Bits 15-8 of divisor, when 
DLAB = 1 


Serial 1, interrupt enable register, where: 
Bits 7-4 = 0 Reserved 


Bit 3 = 1 Modem status interrupt enable 

Bit 2 = 1 Receiver line status interrupt 
enable 

Bit 1 = 1 Transmitter holding register 
empty interrupt enable 

Bit O = 1 Received data available interrupt 


enable when DLAB = 0 


Serial 1 Interrupt ID Register, where: 


Bits 7-3 = 0 Reserved 
Bits 2-1 =00b Modem status interrupt 
O1ib Transmitter holding register 
empty Interrupt 
10b Received data available 
register interrupt 
Receiver line status interrupt 


11b 
Bit 0 = 0 Interrupt pending 


continued 
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Hardware I/O Port List, Continued 


Table: Hardware 1/0 Port epaiaile cont’d 


Read/Write 
0 Address Status Description 


O3FAh | Serial 1, FIFO Control Register, where: 


Bits 7-6 = Receiver FIFO register trigger 
00b = 1 byte 
O1b = 4 bytes 
10b = 8 bytes 


11b = 14 bytes 
Bits 5-3 = 0 Reserved 
Bit 2 = Transmitter FIFO register reset 
1 = transmit FIFO register cleared, 
counter cleared, bit is self- 
clearing 
Bit 1 = Receiver FIFO register reset 
1 = receiver FIFO register cleared, 
counter cleared, bit is self- 
clearing 
Bit O = FIFO enable 
1 =receiver and transmitter FIFOs 
enabled, must be 1 to program 
FIFO registers 
0 = clears receive and transmit 
FIFO registers, enters 
character mode 


Serial 1, Line Control Register, where: 


Bit 7 = 0 Receiver Buffer, Transmitter 
Holding, or Interrupt Enable 
Registers Access 


= 1 Divisor Latch Access 

Bit 6 = 1 Set Break Enabled 
Bit 5 = Stick Parity 
Bit 4 = Even Parity Select 
Bit 3 = Parity Enable 
Bit 2 = 01 Stop Bit 

= 10 Stop Bits 
Bits 1-0 = 00b 5 Bit Word Length 


O1b 6 Bit Word Length 
10b 7 Bit Word Length 
11b 8 Bit Word Length 
Serial 1, Modem Control Register, where: 
Bits 7-5 = 0 Reserved 


Bit 4 = 1 Loopback mode 

Bit 3 = 1 Enable OUT2 interrupt 

Bit 2 = 1 Force OUT1 active 

Bit 1 = 1 Force request to send active 


Bit O 1 Force data terminal ready active 


continued 
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Hardware I/O Port List, Continued 


Table: Hardware I/O Port Definitions, cont’d 


Read/Write 
1/O Address Status Description 


O3FDh R/W Serial 1, Line Status Register, where: 

Bit 7 = 0 Reserved 

Bit 6 = 1 Transmitter shift and holding regis- 
ters empty 

Bit 5 = 1 Transmitter holding register empty 

Bit 4 = 1 Break interrupt 

Bit 3 = 1 Framing error 

Bit 2 = 1 Trailing edge ring indicator 

Bit 1 = 1 Overrun error 

Bit 0 = 1 Data ready 


O3FEh Serial 1 Modem Status Register, where: 

Bit 7 = 1 Data carrier detect 
Bit 6 = 1 Ring indicator 
Bit 5 = 1 Data set ready 
Bit 4 = 1 Clear to send 
Bit 3 = 1 Delta data carrier detect 
Bit 2 = 1 Trailing edge ring indicator 
Bit 1 = 1 Delta data set ready 

| Bit O = 1 Delta clear to send 


k 


O3FFh PR Serlal 1, Scratch register | 
0680h Manufacturing checkpoint port 


3220-3227h See Serial Port 3 (see description for addresses 
03F8h-O03FFh 03F8h-O3FFh for details). 

3228-322Fh See Serial Port 4 (see description for addresses 
03F8h-O03FFh 03F8h-03FFh for details) . 

4220-4227h See Serial Port 5 (see description for addresses 
03F8h-03FFh O3F8h-03FFh for details) . 


4228-422Fh See Serial Port 6 (see description for addresses 
O3F8h-O3FFh O3F8h-O3FFh for details) 

§220-5228h See Serial Port 7 (see description for addresses 
O3F8h-03FFh 03F8h-03FFh for details). 

5228-522Fh See Serial Port 8 (see description for addresses 
O3F8h-03FFh O3F8h-03FFh for details). 
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Chapter 3 
System RAM Data 


Overview 


Introduction 


The CBIOS makes use of information stored in system RAM. The table below 
characterizes each of these areas. 


Interrupt Vector 00h to 3FFh Interrupt vectors stored as offset/segment 
Table format. 


CBIOS Data Area | 400h to 4FFh CBIOS work area. Contains data definitions 
related to CBIOS fixed disk, diskette, key- 
board, video, and other BIOS features and 
functions. 


Extended CBIOS Varies: See Extended CBIOS work area. Contains point- 
Data Area INT 15h, AH=Cth ing device (mouse) data definitions and fixed 
disk parameters. 


In this chapter 


This chapter presents the following information: 
» Interrupt Vectors 

= CBIOS Data Area 

=» CBIOS Extended Data Area 
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Interrupt Vectors 


Interrupt vector table 


76 


The table below identifies each interrupt by function and type. Where appli- 
cable, it lists the interrupt vector address initialized by the CBIOS at POST. 


Note: Further discussion of interrupts is limited to those interrupts directly 
related to the CBIOS. The column labeled “Ref. Chapter” tells where 
to turn for more information on a particular interrupt. 
wr | runstion | tape _| vector | ci 
INT Type Vector Chap. 
[con | Dido by zero SSC; =Ctocl «| | 
[ein | Sige step ites |] 
[ean | areatpome | too fT 
[oan | Overtow SS SSC* Cte «ST 
[avai Op Code i CHaratware [| 


Invalid Task Segment State ) Hardware | 


| OB Serial Communications (COM2) 
| OCH Serial Communications (COM1) | Hardware | 


Parallel Printer (LPT2) | Hardware | | 


O6h 
07h 
08h 
09h 
OAh 
OBh 
0Ch 
OFh 
san __| Seria Communication ‘| software | FE799h 
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Interrupt Vectors, Continued 


Interrupt vector table, cont’d 


[ton | video Pararetere Tae | 8108 Table | FFORAH 
Tien Distette Parameters Tatio | 6108 Table [ FeFo™ 
Taan-arh [Reserved foroos STS 
a [sonar 


EGA Default Video Driver | BIOS Table | 
et a 
44h-45h Reserved | fet, 4 


| 46h Fixed Disk Parameter Table BIOS Table FE401h 


40h 

42h 

46h 

Taimeasn [resoved SOC 
[aan | User alan SSC~*idCer 
[onsen _| Reserved for User Program itoruptal| veer | 
[em [umens over 
a 
a 

r 
I 
a 


_ 
ao 
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CBIOS Data Area 


Introduction 


The CBIOS uses system RAM for storage of data definitions specific to the 
CBIOS. 


System RAM summary 
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The table below lists the system RAM data definitions in offset order. Offsets 
are from segment address 40:0h. 


BIOS 
Location Service Description 
INT 14h 1/O address of up to 4 asynchronous communica- 
tions adapters © 


INT 17h 1/0 address of up to 3 printer adapters 
| 10h 


a Extended CBIOS data area segment 


INT 11h Number of devices installed, where: 

Bits 15-14 = Number of printer adapters 

Bits 13-12 = Reserved 

Bits 11-9 = Number of asynchronous 
adapters (RS232) 

Bits 8 = Reserved | 

Bits 7-6 = Number of disk drives, where: 
00b = 1 Disk drive 
01ib = 2 Disk drives 

Bits 5-4 = Initial video mode, where: 
00b = EGA/VGA or PGA 
01b = 40x25 color 
10b = 80x25 color 
11b = 80x25 black and white 


Bit 3 = Reserved 

Bit 2 = Pointing device 

Bit 1 = 1 If math coprocessor 

Bit 0 = Diskette available for boot 


INT 12h _ Installed memory in Kilobytes minus 1K used by 
the extended BIOS data area 


continued 
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CBIOS Data Area, Continued 


System RAM summary, cont’d 


BIOS 
Location Service Description 


17h INT 16h Keyboard shift flags, where: 
Bit 7 = 1 Insert active 
Bit 6 = 1 Caps Lock active 
Bit 5 = 1 Num Lock active 
Bit 4 = 1 Scroll Lock active 
Bit 3 = 1 Alt pressed 
Bit 2 = 1 Ctrl pressed 
Bit 1 = 1 Left Shift pressed 
Bit 0 = 1 Right Shift pressed 


More keyboard shift flags, where: 


INT 16h 
Bit 7 = 1 Insert pressed 
Bit 6 = 1 Caps Lock pressed 
Bit 5 = 1 Num Lock pressed 
Bit 4 = 1 Scroll Lock pressed 
Bit 3 = 1 Ctri-Num Lock state active 
Bit 2 = 1 Sys Req pressed 
Bit 1 = 1 Left Alt pressed 
Bit 0 = 1 Left Ctrl pressed 


INT 16h Work area for Alt key and numeric keypad input | 
| TAR INT 16h Pointer to next character in keyboard buffer 


INT 16h Pointer to first available spot in keyboard buffer 
INT 16h Keyboard buffer of 16 word entries 


INT 13h Diskette drive recalibrate status, where: 


Bit 7 = 1 Diskette hardware interrupt has 
occurred 

Bits 6-4 = Not used 

Bits 3,2 = Reserved 

Bit 1 = Recalibrate drive 1 

Bit 0 = Recalibrate drive 0 


Diskette motor status, where: 


INT 13h 


Bit 7 = 1 Current operation is a write or format 
= 0 Current operation is a read or verify 
Bit 6 = Reserved 


Bits 5,4 = Drive select states where: 


00 = Drive 0 selected 
01 = Drive 1 selected 
10 = Reserved 
11 = Reserved 


Bit 1 = 1 Drive 1 motor is on 
Bit 0 = 1 Drive 0 motor is on 
INT 13h Diskette motor time-out count 


continued 
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CBIOS Data Area, Continued 


System RAM summary, cont'd 


80 


BIOS 
Location Service Description 


41h INT 13h Diskette status return code, where: 
Bit 7 = 1 Drive not ready 
Bit 6 = 1 Seek error occurred 
Bit 5 = 1 Diskette controller failed 
Bits 4-0 = Error codes, where: 
= 00h No error 
= Oth Illegal function was requested 
, = 02h Address mark not found 
= 03h Write protect error 
04h Sector not found 
06h Drive door was opened 
08h DMA overrun error 
| 09h DMA boundary error 
OCh Media type unknown 
. 10h CRC failed on disk read 


[om IOm | Video mode voting 


INT 10h Cursor position on each page. Two bytes/page. 
First byte of each pair is column; second byte is 
row. 0,0 is upper left corner of screen. 


INT 10h Cursor type defined as 6845 video chip-compatible 
starting and ending scan lines. High byte is starting 
scan line; low is ending scan line. 


INT 10h Current page number 


INT 10h 6845-compatible I/O port number for current mode 
(Port 03D4h or 03B4h) 
INT 10h Current mode select register 
INT 10h Current palette value 


mode re-entry 
| ssh__—|_—Post__| Last unexpected interrupt that ocourred 
[seh [nt tah | Moot sarfloant ter count 
[wor [nt van [at hourrotover tag 


continued 
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CBIOS Data Area, Continued 


System RAM summary, cont’d 


BIOS 
Location Service Description 


INT 16h Ctrl-Break flag 
72h POST System Reset Flag, where: 
1234h = Bypass memory test 
74h INT 13h 
CCh = Write fault on selected drive 
EOh = Status error/error register is 0 
FFh = Sense operation failed 


4321h = Reserved for ABIOS 
INT 13h Number of fixed disks 
System RAM Data | 81 


09h = Data boundary error 

OAh = Bad sector flag detected 

OBh = Bad track detected 

ODh = Invalid number of sectors on format 
OEh = Control data address mark detected 
OFh =DMaA arbitration level out of range 
10h = Uncorrectable ECC or CRC error 
11h =ECC corrected data error 

20h = General controller failure 

40h = Seek operation failed 

80h = Time-out 

AAh = Drive not ready 

BBh = Undefined error occurred 


Status from last fixed disk operation, where: 
0Oh =No error 
O1h = Invalid function request 
02h = Address mark not found 
03h = Write protect error 
04h = Sector not found 
O5h = Reset failed 
07h = Drive parameter activity failed 
INT 13h Fixed disk control byte 
INT 17h Fixed disk port offset 
INT 14h Printer time-out table (ports 1-3) 
INT 16h Serial time-out table (ports 0-3) 
INT 16h 40h) to start of keyboard buffer (from segment 
INT 10h 40h) to end of keyboard buffer (from segment 
INT 10h Number of rows on screen (24/25) 
INT 10h Character height (bytes/character) 


08h = DMA overrun on operation 
continued 


CBIOS Data Area, Continued 


System RAM summary, cont'd 


BIOS 
Location Service Description | 


87h INT 10h Video control bits, where: 
Bit 7 = Clear RAM 
Bit 6,5 = Memory on adapter as follows: 
| 00b = 64K 
O1b = 128K 
Bit 4 = Not used 
Bit 3 = 0 EGA/VGA-compatible adapter active 
Bit 2 = Wait for display enable 
Bit 1 = 0 Color or ECD monitor is attached to 
EGA/VGA-compatible adapter 
| = 1 Monochrome monitor is attached to 
| EGA/VGA-compatible adapter 
Bit 0 = 0 Translate cursor video modes 0-3 
when using ECD monitor in 350 line 
mode 
= 1 Inhibit cursor translation 


INT 10h EGA/VGA switch data where: 


Bits 7-4 = Feature connector bits 3-0, respectively | 
Bits 3-0 = Option switches 3-0, respectively 


| INT 10h EGA/VGA control bits, where: 

Bit 7 = 200 lines 
Bits 6-5 = Reserved 

| Bit 4 = 400 lines 
Bit 3 = No palette load 

| Bit 2 = Mono Monitor 
Bit 1 = Gray Scalling 
Bit 0 = Reserved 


INT 13h Diskette data rate information | 


Bits 7,6 = Last data rate set by controller, where: 
00b = 500 Kilobytes/second (Kbs) 

| 8Ch INT 13h Fixed disk status register 

| BDH] INT 13h Fixed disk error register 


11b = Reserved 
4 = Last diskette drive step rate selected 
2 = Data transfer rate at operation start, 


Bits 5, 
Bits 3, 


where: 

00b = 500 Kbs 
01b = 300 Kbs 
10b = 250 Kbs 


11b = Reserved 
Bits 1,0 = Reserved 


01b = 300 Kbs 
INT 13h Fixed disk interrupt flag 


10b = 250 Kbs 
continued 


82 | CBIOS for IBM PS/2 Computers and Compatibles 


CBIOS Data Area, Continued 


System RAM summary, cont’d 


BIOS 
Location Service Description | 


8Fh INT 13h Diskette controller information, where: 

Bit 7 = Reserved 

Bit 6 = | Drive determined for drive 1 
Bit 5 = 1 Drive 1 is multirate 

Bit 4 = 1 Drive 1 supports change line 
Bit 3 = Reserved 

Bit 2 = 1 Drive determined for drive 0 
Bit 1 = 1 Drive 0 is multirate 

Bit 0 = 1 Drive 0 supports change line 

drive 


INT 13h Media type of both drives: 
000b = Trying 360K media in 360K drive 


(One byte per drive. drive 0 at 40:90h; drive 1 at 

40:91h) 
INT 13h Diskette device service work area. Each entry is 
first diskette device service value tried. One byte 
| per drive. Drive 0 at 92h, Drive 1 at 93h. 
94h INT 13h Current track number for both drives. One byte per 

drive. Drive 0 at 94h, drive 1 at 95h. 
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b = 500 Kbs 
01b = 300 Kbs 
10b = 250 Kbs 
Bit 5 = 1 Double stepping required 
(360K media/1.2 MB drive) 
Bit 4 = 1 Known media in drive 
Bit 3 = Reserved 
Bits 2-0 = Definitions on return to user: 
11b = 720K media in 720K or 1.44 MB 
drive; or 1.44 MB media in 
1.44 MB drive 
101b = Known 1.2 MB media in 1.2 MB 


drive 
100b = tari 360K media in 1.2 MB 


rive 

011b = Known 360K media in 360K drive 

010b = Trying 1.2 MB media in 1.2 MB 
drive 

001b = Trying 360K media in 1.2 MB 


Bits 7,6 = aie Transfer Rate, where: 
INT 16h Status byte: 

Bit 7 = 1 Read ID in progress 

Bit 6 = 1 Last code was first ID 

Bit 5 = 1 Forced Num Lock 

Bit 4 1 101/102 keyboard used 

Bit 3 1 Right Alt active 

Bit 2 1 Right Ctri active 

Bit 1 1 Last code was EOhn 

Bit 0 1 Last code was Eth 


continued 


CBIOS Data Area, Continued 


System RAM summary, cont’d 


84 


BIOS | | 
Location Service Description 


INT 16h Status byte: . 

Bit 7 Error flag for keyboard command 
Bit 6 LED update in progress 
Bit 5 RESEND received from keyboard 
Bit 4 = ACK received from keyboard 
Bit 3 = Reserved 

| Bit 2 = Current status of Caps Lock LED 
Bit 1 = Current status of Num Lock LED 
Bit O = Current status of Scroll Lock LED 


Least significant wait count 


INT 15h Wait active flag, where: 
Bit 7 = 1 Wait time elapsed 
Bits 6-1 = Reserved 
Bit 0 = 1INT 15h, AH = 86h occurred 


B6h-B8h POST Reserved for POST 


97h 
9Ah 
9Ch 
| 9Eh 
AOh 
A8h ides (i 
INT 15h Count of days since 1-1-80 


INT 10h Pointer to video parameters and overrides (in 
segment: offset format) 
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CBIOS Extended Data Area 


The following table lists the definitions for the extended data area located 
at the top 1K of system RAM. The segment of the extended data area is 
defined at location 40:0Eh of the BIOS data area. 


Number of bytes allocated in multiples of Kilobytes 
1 Byte Number of POST error codes 
| 22h | 1 Word Device driver far call offset 
| 24h | Device driver far call segment 
1 Byte Pointing device flag (1st byte) 
Bit 7 = 1 Command in Progress 
Bit 6 = 1 Resend 
Bit 5 = Acknowledge 
Bits 6-3 = 0 Reserved 
Bits 2-0 = Package Size 
1 Byte Auxiliary device data 
| 1 Byte Auxiliary device data 
Auxiliary device data 


22h 

24h 

26h 
Bit 4 Error 
Bit 3 


0 Reserved 


Pointing device flag (2nd byte) 
Bit 7 = 1 Device driver far call flag 


Bits 2-0 = Index count 
Auxiliary device data 
Auxiliary device data 
peeved SS 


2 Words The interrupt vector for INT 01h is stored here during 
INT 07h emulation code 


continued 
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CBIOS Extended Data Area, Continued 


| a a 1 Byte | Where the low byte of the MSW is stored by the | 
| 80287/80387 interrupt code 


| = 1Word | ‘Watchdog Timer (Counter 3) initial count . | 


16 Bytes Fixed disk parameter table for drive 0, where: 


| Location 


Offset Size Description 

00h Word Max number of cylinders 

02h Byte Max. number of heads 

03h Word Reserved 

05h Word Starting write precompensation 
cylinder 

07h Byte Not used 

08h Byte _ Control byte 

09h Byte Reserved 

OAh Byte Reserved 

OBh Byte Reserved 

0Ch Word Landing zone 

OEh Byte Number of sectors/track 


OFh Byte Reserved 7 


16 Bytes Fixed disk parameter table for drive 1, where: 
Offset Size Description 
00h Word Max number of cylinders 
02h Byte Max. number of heads 
03h Word Reserved 
05h Word Starting write precompensation 
| cylinder 
07h Byte Reserved 
08h Byte Control byte 
09h Byte Reserved 
OAh Byte Reserved 
OBh Byte Reserved 
0Ch Word Landing zone 
OEh Byte Number of sectors/track 


Fixed Disk arbitration level and channel 
number, where: 


Bits 7-4 = Channel number (OOh-OFh) 
Bits 3-0 = DMA arbitration level (OOh-OEh) 


3FOh | 1 Byte Fixed disk buffer 
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Chapter 4 
CMOS RAM Data 


Overview 


Introduction 


The ROM uses nonvolatile CMOS RAM to store real time clock, system 
configuration, system diagnostic, and other information. 


Note: The information contained in CMOS is referenced by both the CBIOS 
and the ABIOS portions of the BIOS. CMOS RAM information is in- 
cluded here for the convenience of CBIOS users. ABIOS users will 
find this information repeated in AB/IOS for IBM PS/2 Computers and 
Compatibles. 


continued 
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Overview, Continued 


Where CMOS RAM data is located 


Information may be stored in up to two areas of CMOS RAM. The table 
below describes the CMOS RAM areas available to the CBIOS. 


V0 


CMOS RAM 070h & 071h 64 bytes These bytes are located on the Motorola 

-_Data Area MC146818A Real Time Clock CMOS chip 
(or its equivalent). All implementations. 
of the BIOS make use of this area to 
store real time clock, POST, and system 
configuration data. 


Extended CMOS | 074h, 075h, 2K bytes When implemented on systems that em- 
RAM Data Area and 076h ploy more than four adapter slots, the 
BIOS requires an additional 2K of CMOS 
RAM. This extended CMOS RAM is pri- 
marily used to store POS data. 


In this chapter 


This chapter defines the contents of the CMOS RAM data areas. The follow- 
ing topics are presented: 

# CMOS RAM 1|/O Ports 

«= CMOS RAM Data 

» Extended CMOS RAM Data 
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CMOS RAM I/O Ports 


The CBIOS accesses the CMOS RAM data areas through the following I/O 
ports. 


Read/Write 
1/O Address Status Description 
W 


CMOS RAM address register port, where: 


Bit 7 = 1 NMI disable 
= 0 NMI enabled 
Bits 6-O = 0 CMOS RAM address 


0071h a CMOS RAM data register port 
Extended CMOS RAM address register port, 
least significant byte 
0075h Extended CMOS RAM address register port, 
most significant byte 
— Extended CMOS RAM data register port 


CMOS RAM Data 


CMOS RAM Data 


Introduction 


The CBIOS uses 64 bytes of CMOS RAM located in the Motorola MC146818A 
Real Time Clock CMOS chip to store real time clock and configuration data. 
The tables below present the following CMOS RAM data definitions: 

» Real time clock 

= Real time clock status registers 

# Configuration 


Real time clock data definitions 


Real time clock information uses CMOS RAM addresses OOh-O9h. These data 
definitions are presented below in offset order. 


; Description in binary coded decimal 


continued 
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CMOS RAM Data, Continued 


Status registers data definitions 


The real time status registers use CMOS RAM addresses OAh-ODh. These 
data definitions are presented below in offset order. 


OAh 3 


Status register A, where: 


Bit 7 = 1 Update in progress 

Bits 6-4 = Divider identifying the time-based 
frequency to use 

Bits 3-0 = Rate selection bits that define output 

frequency and periodic interrupt rate 


Status register B, where: 


Bit 7 = 0 Run 
= 1 Halt 
Bit 6 = 1 Enable periodic interrupt 
Bit 5 = 1 Enable alarm interrupt 
Bit 4 = 1 Enable update-—ended interrupt 
Bit 3 = 1 Enable square wave interrupt 
Bit 2 = 1 Calendar is in binary format 
= 0 Calendar is in BCD format 
Bit 1 = 1 24-hour mode 
= 0 12-hour mode 
Bit 6 = 1 Enable Daylight Savings Time 


Status register C, where: 


Bits 7-4 = IRQF, PF, AF, and UF flags, 
respectively 
Bits 3-0 = Reserved 


Status register D, where: 


Bit 7 = 1 Real time clock has power 
Bits 6-0 = Reserved 
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CMOS RAM Data, Continued 


Configuration data definitions 


The system configuration information data definitions use CMOS RAM ad- 
dresses OEh-3Fh. These data definitions are presented below in offset order. 


Diagnostic status, where: 


Bit 7 = 1 Real time clock lost power 
Bit 6 = 1 CMOS RAM checksum is bad 
Bit 5 = 1 Invalid configuration information found 
at POST 
Bit 4 = 1 Memory size compare error at POST 
| Bit 3 = 1 Fixed disk or adapter fails initialization 
| Bit 2 = 1 CMOS RAM time found invalid 
Bit 1 = 1 Adapters do not match configuration 
Bit 0 = 1 Time-out reading an adapter ID 


Reason for shutdown, where: 


00h = Power on or soft reset 

Oth = Memory size pass 

02h = Memory test pass 

03h = Memory test fail 

04h = POST end; boot system | 
| O5h = JMP DWord pointer with end-of-interrupt 
| O6h = Protected tests pass 

07h = Protected tests fail 
| O8h = Memory size fail 

09h = INT 15h Block Move 

OAh = JMP DWord pointer without end-of- 

interrupt 


OBh = Used by ABIOS 


Type of diskette drives: 


Bits 7-4 = Drive type of drive 0, where: 
0000b = No drive 
0001b = 360K drive 
0010b = 1.2 MB drive 
0011b = 720K 
0100b = 1.44 MB 
Bits 3-0 = Drive type of drive 1, where: 
0000b = No drive 
0001b = 360K drive 
0010b = 1.2 MB drive 
0011b = 720K 
0100b = 1.44 MB 


Type of fixed disk drive 0 | 
Type of fixed disk drive 1 | 
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CMOS RAM Data, Continued 


Configuration data definitions, cont’d 


1 Byte Password Configuration 


Bits 7-5 = 0 Reserved 
Bit 4 = 0 BIOS initializes keyboard to normal 


speed 
1 BIOS initializes keyboard to fast speed* 
Bits 3-2 = Reserved 


Bit 1 = 1 Network password installed 
= 0 Network password not installed 
Bit 0 = 1 Power-on password installed 


= 0 Power-on password not installed 


Equipment installed, where: 


Bits 7-6 = Number of diskette drives, where: 
00b = 1 Diskette drive 
01b = 2 Diskette drives 
Bits 5-4 = Primary display, where: 
00b = Reserved 
01b = VGA in 40-column mode 
10b = VGA in 80-column mode 
11b = VGA in monochrome mode 
Bits 3-2 = Reserved 
Bit 1 = 1 80387 installed 
Bit 0 = 0 Diskette drive installed 


pogo 1 Byte Base memory in 1K, low byte 


1 Byte 


1 Byte POS 3 configuration byte for channel 0 
“if the machine has extended CMOS RAM, the value for the fast speed is taken from 
offset 702h. 
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CMOS RAM Data, Continued 


Configuration data definitions, cont’d 


Description | 


1 Byte POS 2 configuration byte for channel 3 


1 Byte POS 3 configuration byte for channel 3 
 2Fh 1 Byte | POS 4 configuration byte for channel 3 
1 Byte POS 5 configuration byte for channel 3 


1 Byte Copy of system board POS 2 
1 Byte CRC for offsets 10-31, high byte 
1 Byte CRC for offsets 10-31, low byte 


34h 1 Byte Miscellaneous information 


Bits 7-4 = Actual number of RS-232 ports installed 
Bits 3-0 = canoe move status before reset to real 
mode 
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Extended CMOS RAM Data 


Introduction 


The BIOS uses an additional 2K of CMOS RAM to store Programmable Option 
Select (POS) data for MCA-compatible computer systems that include more 
than four expansion slots. Fixed disk parameter data for fixed disks other 
than those listed in the ROM BIOS Fixed Disk Parameter Table are also 
stored in this extra CMOS RAM. 


Extended CMOS RAM data definitions 


The table below outlines the contents of the extended CMOS RAM data area. 


CMOS RAM 
Offset Description 


0000h LSB of adapter ID for channel 0 


0003h 1 Byte 
0004h 1 Byte 


| ooosh_— | Byte 
0006h 
o07-0022h | 


| oozsn_— |i Byte | LSBof adapter ID for channel 
[oven | __18yte | _MSB of adapter ID for channel) 
| oozsn_— | t Byte | POS4forchannel) 
Tooem-oosh |i Reserved 
0047h MSB of adapter ID for channel 2 


0048h Number of POS values used 


0049h POS 2 for channel 2 
004Ah POS 3 for channel 2 = 


continued 


[—eooan | 18yt0 | Number of POS vahes wood 
[Veyte [P08 2 forchammel 9 
[ros 5 for chanel 0 


Reserved 
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Extended CMOS RAM Data, Continued 


Extended CMOS RAM data definitions, cont’d 


96 


a A ee 
Offset Size ‘| Description | 

004Ch 
006 Ah 
006Bh Number of POS values used 


008Fh : | 
0090h POS 3 for channel 4 
009th 


continued 
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Extended CMOS RAM Data, Continued 


Extended CMOS RAM data definitions, cont’d 
CMOS RAM 
Offset 
00D4h 
00D5h 
00D6h 
00D7h 
0OD8h 
0OD9-00F4h 
OOF5h 
OOF6h 
OOF7h | 

OOF8h 
OOF9h 
OOFAh 


Description 

Number of POS values used 
POS 2 for channel 6 

POS 3 for channel 6 

POS 4 for channel 6 

POS 5 for channel 6 


1 Byte 
1 Byte 
1 Byte 
1 Byte 
1 Byte 
Reserved 
1 Byte LSB of adapter ID for channel 7 
1 Byte 


MSB of adapter ID for channel 7 

1 Byte | 
1 Byte 

1 Byte POS 3 for channel 7 
1 Byte POS 4 for channel 7 
OOFBh 1 Byte POS 5 for channel 7 


00FC-0160h 


0161-0162h 1 Word Set to a value to make POST’s CRC for extended 
CMOS RAM locations 0-162 equal zero. Main- 


Number of POS values used 
POS 2 for channel 7 


tained by the Reference Diskette. 


0163-0165h 

0166-0175h 

0176-0185h 
0186h 


16 Bytes 
16 Bytes 
CMOS RAM can be accessed correctly. 


continued 


0187h-0188h 

0189h-018Dh 
018Eh 

018Fh-0388h 
0389h 
038Ah 
039Eh 


03B2h 
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Extended CMOS RAM Data, Continue 


CMOS RAM 


Extended CMOS RAM data definitions, cont’d : 


Offset : i. Description 


oaD A 
oaoan-06FFh_| 20 Bytes | Revoved SSCS 
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Chapter 5 
ROM BIOS Data 


Overview 


Introduction 


In addition to the code for the various CBIOS services, the ROM BIOS also 
contains tabular data that is used to initialize devices and to insure IBM 
family compatibility. 


In this chapter 
This chapter defines the contents of the ROM BIOS data areas. The following 
topics are presented: 
«= ROM Address Compatibility Table 
» System Configuration Data Table 
» Feature Control 
» Diskette Parameters Table 
» Fixed Disk Parameters Table 
» Baud Rate Initialization 
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ROM Address Compatibility Table 


Description 


The Phoenix CBIOS maintains compatibility by providing a list of jump instruc- 
tions that insure that both table information and calls to specific CBIOS 
services are located at the IBM-compatible entry points. 


Compatible ROM Addresses 


[7 Fewin | Fired Dek Parameters Table SSSCS~*” 


FE6F5h 
FE729h Baud Rate Generator Table 
FE739h Compatible INT 14h Serial Communications Service Entry Point 


FE82Eh | Compatible. INT 16h Keyboard Service Entry Point 


Configuration Data Table 
FE987h Compatible INT 09h Keyboard Service Entry Point 


| FE6F2h | Compatible INT 19h Boot Load Service Entry Point 
| FEC59h Compatible INT 13h Diskette Service Entry Point 


[_FeFD2n | Compatible INT 17h Printer Service Enty Pont 
[—FFossn | ~Compatibie INT 10 Functions O-Fh Entry Ponti 
[FFoesn | compatibie IT 10h Video Support Service Enty Pot 


FFA6Eh Character Font for 320X200 and 640X200 Graphics (lower 128 
characters) 


FFE6Eh Compatible INT 1Ah Time-of-day Service Entry Point 
FFEASh | Compatible INT 08h System Timer ISR Entry Point 


continued 
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ROM Address Compatibility Table, Continued 


Compatible ROM Addresses, cont’d 


Address Description 


FFFFEh System Model ID (See System Services) 


ROM BIOS Data 101 


System Configuration Data Table 


Description 


The System Configuration Table is located in the CBIOS ROM at FOOO:E6F5h. 
This table can be called into RAM via INT 15h function AH = COh Return 
System Configuration Parameters. 


Parameter table structure 


initial 
value Length | Description 


A OO EL Number of bytes in this table (minimum = 8) 


1 Model byte, where: 
Model 80 = F8h 


Model 70 = F8h 
Model 60 = FCh 


Model 50 = FCh 
Model 30 = FAh 
Model 25 = FAh 


Unknown system board = FFh 


Submodel byte, where: 


Model 80 = 00h or Oth 
| Model 70 = 09h 
Model 60 = 05h 
Model 50 = 04h 
Model 30 = 00h 
Model 25 = Oth 
Unknown system board = FFh 


| oth ft] Byte BIOS revision level (first release = 00b) 


aS Feature information byte, where: 


Bit 7 = 1 Fixed disk BIOS uses DMA channel 3 
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Bit 6 = 1 Second interrupt chip present 

Bit 5 = 1 Real time clock present 

Bit 4 = 1 Keyboard intercept (INT 15h, function 
AH = 4Fh) called by keyboard interrupt 
service (INT 09h) 

Bit 3 = 1 Wait for external event supported 

Bit 2 = 1 Extended BIOS data area is allocated 

Bit 1 = 1 Micro Channel supported 

= 0 PC-type I/O channel implemented — 
Bit 0 = 0 Reserved 


Feature information byte 5 Von zeros) 


Feature Control 


Description 


The PS/2 BIOS is designed to use the configuration control information in the 
System Configuration Table, which is accessed using CBIOS INT 15h function 
COh, Return System Configuration Parameters. 


However, the System Configuration Table does not provide enough informa- 
tion for a PS/2 BIOS to operate properly. Additional data about the system 
configuration is stored at location FOO00:E97Fh, and is described below. 


Using PS/2 model features as configuration parameters 


There are several system features which can be used as system configura- 
tion parameters to define PS/2-compatible models. These features are: 


= number of adapter slots, 

=» existence of extended CMOS RAM, 

*" position of the password disable bit, and 

» the memory encoding and memory definition register implementation. 


The features listed above are used as parameters by the BIOS to distinguish 
various PS/2-compatible system configurations. 


Feature table 


The following table describes how these features vary among several PS/2 
models. 


16MHz | 20 MHz 
Feature Model 50 Model 60 Model 80 Model 80 


Yes 


continued 
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Feature Control, Continued 


Setting the adapter board data 
The number of adapter boards is described at address FO00:E97Fh. This 


number can be 1 to n. 


four or fewer adapter slots the PS/2 BIOS expects that all slot definitions are 
on the board and extended stored in extended CMOS 

CMOS Is available 

five or more adapter slots extended CMOS RAM must be available 

on the board | 


Use a reference diskette utility to copy the adapter card definitions to CMOS 
RAM to ensure proper system operation. | 


Password disable bit 
The password disable bit is in the POS 3 register of the system board at !/O 
address 0103h. This bit specifies whether the power-on password should 
be checked for or not. The password disable bit is described at address 
FOOO:E980h. A one is required to proceed normally to query the user for 
a password. A zero indicates that the password will be zeroed out. 


If the memory registers are defined, the password disable bit cannot be in 
bits 0-3 of the system board POS slot 3, and must be in bits 4-7. 


Memory register definition 
There are three parts in each memory definition, each one byte long: 


= memory card register, 
=» memory encoding register 1, and 
=» memory encoding register 2. 


The memory registers for IBM Model 80-compatible systems are imple- 
mented differently in 16 MHz and 20 MHz versions. The memory registers 
Start at address FOOO:E981h. | 


PS/2-compatible systems may implement memory register configuration 
on Model 50 or Model 60-compatible systems, since the Intel 80286 and 
80386SX microprocessors support memory encoding. 


104 CBIOS for IBM PS/2 Computers and Compatibles 


Diskette Parameters Table 


Introduction 


The diskette device service routine in older systems supplied a table of 
parameters used to manipulate diskette drives. For compatibility, the diskette 
device service routine must still provide the same table although some of its 
values are modified so that the table is more suited to the default 1.44 MB 
diskette drives. The default 11-byte table is located at FOOO:EFC7h and is 
pointed to by the interrupt 1Eh vector. 


Parameter table structure 


ROM BIOS Data 


The format for the first data byte of the diskette specify 
command is: 


Bits 7-4 = Stepping rate 
Bits 3-0 = Head unload time 


The default stepping rate is OAh for the 1.44 MB drive with a 
1.44 MB diskette inserted. The default head unload time is the 
maximum value of 240 ms (OFh). 


The format for the second data byte of the diskette specify 
command is: 


Bits 7-1 = Head load time 
Bit O = Non-DMA mode flag 


The default head load delay time is set to the minimum value of 
4 ms (01h). The heads are loaded at the same time as the mo- 
tor is started, but the motor delay is much longer so the head 

load time delay is not really needed. The non-DMA mode flag Is 
always set to zero to indicate that DMA is being used. 


Motor turn-off delay. This is the amount of time in timer ticks 
that the diskette device service routine waits before turning off 
an inactive diskette drive motor. Timer ticks occur 18.2 times 

per second and the routine waits about two seconds; therefore 
the default value for this field is 25h. 


Bytes per sector. This field is encoded in the following way to 
match the encoding used by the diskette controller: 


00 = 128 bytes per sector 
01 = 256 bytes per sector 
02 = 512 bytes per sector 
03 = 1024 bytes per sector 


The standard sector size is 512 bytes per sector so the default 
value for this field is 02h. 


continued 
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Diskette Parameters Table, Continued 


Parameter table structure, cont’d 


Description 


End of track. Since the sector numbering is one relative, this 
field is actually the number of sectors per track. For the 1.44 
MB ia in the 1.44 MB drive, this field is 18 sectors per 
trac 


Gap length. This field is the length of the gap between sectors. 
The default value for this field is 1Bh for the 1.44 MB diskette. 


Data length. Since the bytes per sector field is non-zero, this 
field is meaningless and is set to FFh. 


Gap length for format. This field is the length of the gap be- 
tween sectors to maintain when formatting. The default format 
gap length for the 1.44 MB diskette is 6Ch. 


Filler byte. This byte is the format filler byte and is F6h. 


Head seek delay time. This is the amount of time in milliseconds 
the diskette device service routine must wait for the heads to 
settle after doing a seek operation. For the 1.44 MB diskette 
drive, this field is OFh. 


Motor start time. This is the amount of time in eighths of a sec- 
ond that the diskette device service routine must wait for the 
motor ta come up to speed before doing an I/O operation. The 
1.44 MB drive has a motor start time of one second so the 
default value for this field is set to 08h. 
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Fixed Disk Parameters Table 


Description 


The Fixed Disk Parameters Table defines the types of fixed disk drives that 
can be used. As part of system configuration, the INT 41h vector is set up 
to point to the fixed disk parameters entry associated with drive O. If fixed 
disk drive 1 is installed, INT 46h is initialized to point to its corresponding 
entry in the Fixed Disk Parameters table. To maintain compatibility, the Fixed 
Disk Parameters Table is based at FOOO:E401h. 


Parameter table structure 


Each entry in the Fixed Disk Parameters Table occupies 8 words as defined 
below. | 


Description 


1 Byte Control byte, where: 
Bits 2-0 = 0 Reserved 


Bit 5 = 1 Defect map present at max, 
cylinder + 1 

Bit 4 = 0 Reserved 

Bit 3 = 1 More than 8 heads 


Bit 7,6 = 1 Disable retries (either bit disables) 


1 Byte Number of sectors per track 


continued 
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Fixed Disk Parameters Table, Continued | 


Fixed disk parameter entries 


The CBIOS portion of the ROM BIOS defines only the first 32 entries in the 
Fixed Disk Table. Fixed disk type 15 is not used. Definitions for fixed disk 
types 1-32 are located in a 16-byte table starting at FOOO:E40th. 


Table of fixed disk definitions 


The defined entries into the Fixed Disk Parameters table are listed below. 
Wherever possible, the manufacturer name and model number associated 
with a given drive type are listed in the column, “Manufacturer.” 


Write | Landing Sectors/ Defect | 
Type Manufacturer Heads|Precomp| Zone Track 2 


A 


ais iain 

Seagate ST-225 

CDC Wren Il 

9415-5-25 

Miniscribe 8438F 

| 3 | 18m 30 mB pate ft see fe 
IBM 62 MB p5t2 


IBM 46 MB 


IBM 20 MB OFFFFh 
Miniscribe MS 8425 | 
Seagate ST4026 
Tandon TM 262 
Tandon TM 702AT 
733 | 


N 


a [6 


OFFFFh | 


IBM 30 MB 
Seagate ST-4038 
CDC Wren Il 
9415-5-38 
Tandon TM 703AT 


i eee 
— 
— 
| 855 
= 


Tis orreen | oor | 7 | no 
3 _[orreen | eo | a7 | No 
Ts orrern [ess [a7 | ne 
7 orrern | oss [ 7 [No 
eo | [oe | 7 | no 


a 


Note: If a table entry contains OFFFFh for Write Precompensation, then there is no write 
precompensation for this disk. If the write precompensation is zero, then there is 
write precompensation for all eyinaehe: 
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Fixed Disk Parameters Table, Continued 


Table of fixed disk definitions, cont’d 


Write Landing | Sectors/ | Defect 
Type Manufacturer Cyl. Heads| Precomp Zone Track Map 


Not used 
SL A O_  a 
Pew aoms | e77 
Cem seMe | er 
Tew some [wee | 7] are 
Tiewsome | rsa | | 900 
Piemewe | 73 | 7 | 300 
| iemsome | 733 | 5 | 
ee ee 
+ [wemeome | ere | + | aos | ees | 
Piewiome +f aos | 4 a 
Ciewzoma | ov | + | orremn | 670 
a 
fe ao es 
| 306 | 4 | 340 | 
pen | 4 | 663 
732 | 7 | 732 
wes | os | 102s 


IBM 42.5 MB 


If a table entry contains OFFFFh for Write Precompensation, then there is no write 
precompensation for this disk. If the write precompensation is zero, then there is 
write precompensation for all cylinders. 


Note: 
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Baud Rate Initialization 


Baud rate initialization table | | 
The baud rate initialization table is located at FOO0:E729h in the ROM BIOS. 


How baud rate divisor is calculated 


The input frequency to the device is 1.8432 MHz. The values in the table are 
calculated as follows: | 


1,843,200 / 16 = 115200 / Baud Rate = Divisor 


For example, a baud rate of 2400 has a divisor of 115200/2400, which 
equals 48 decimal, 30 hex. 
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Chapter 6 
Power-On Self Tests (POST) 


Overview 


Introduction 


Before a computer system can be used, all system Components must be 
tested and initialized, and the operating system must be bootstrapped into 
memory. The process of system test and initialization is generally under the 
control of the computer system’s ROM BIOS. It is commonly referred to by 
the acronym POST, for power-on self test and initialization procedure. 


ABIOS and POST 


The POST procedure is contained in the CBIOS portion of the BIOS code. 
The ABIOS is not in any way associated with POST. 


Model 25/30 POST 


Error messages and POST procedures that are specific to the PS/2 Model 
25 and Model 30 are documented in Appendix C. 


continued 
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Overview, Continued 


How POST is started 
The CBIOS POST process can be started in any of the ways described in the 


table below: 
| Start Method CBIOS Behavior 
Jump to entry point indicated by the processor reset vec- 


Apply power to system 
(i.e. turn system on.) tor. All POST tests and initializations are executed. POST 
ese CBIOS INT 19h, Operating System Bootstrap 
oader. 


| Reset system via op- 
tional hardware reset 
button. 


Jump to entry point indicated by the processor reset vec- 

tor. All POST tests and initializations are executed. POST 

tones CBIOS INT 19h, Operating System Bootstrap 
oader. 


INT 09h keyboard hardware interrupt service routine trans- 
fers control to CBIOS POST. The POST test and initializa- 
tion of memory above 64K is not executed. All other POST 
tests and initializations are executed. POST invokes CBIOS 
INT 19h, Operating System Bootstrap Loader. 


Press <Ctrl> <Alt> <Del> 
(warm boot) 


Processor reset vector location 


To maintain compatibility, the processor reset vector points to address 
FOO0:0000h. This vector is also dual mapped by external address selection 
logic to point to FFFFF:00000h — the 80286/80386 reset vector address. 


In this chapter 


This chapter presents the following information: 
=» POST Procedures 

= Rules for Positioning 1/O Expansion ROM 

» Re-entering Real Mode 

» INT 19h, INT 18h, and System Boot 

# POST Error Handling 
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POST Procedures 


Introduction 


The initialization and self test functions of the POST process are tightly 
interwoven. The processes can be generally thought of, however, as falling 
into two categories: 

= Processes related to the central system hardware 

= Processes related to configuration and nonsystem board hardware 


How POST handles errors 


If POST finds errors on its first pass through the boot procedure, it looks for 
the Reference Diskette in Diskette Drive A:. If the Reference Diskette is not 
in Drive A:, POST generates a message, Press F1 to Retry. 


If the Reference Diskette is in Diskette Drive A:, POST causes it to load so 
the error message can be handled by the end user. 


Note: See the POST Error Handling information in this chapter. 


Central hardware POST tests 


Because the proper functioning of the central hardware is required before 
further POST tests can occur, the most central hardware is first tested, then 
initialized. 
POST tests and initializes the following central system components in the 
order listed below: 
» The Central Processing Unit (CPU) 
» ROM BIOS (checksum) 
» CMOS RAM 
# Intel 8237 Direct Memory Access (DMA) Controller 
# Intel 8042/8742 Keyboard Controller 
= Base 64K System RAM 
# Intel 8259A Programmable Interrupt Controller 
= Intel 8254A Programmable Timer 
» Intel 82385 Cache Controller, if present 


continued 
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POST Procedures, Continued 


Nonsystem hardware POST tests 


Once the central hardware has been tested and initialized, POST verifies that 
the system configuration specified in CMOS matches the actual hardware 
present. The remaining POST procedures test and initialize memory above 
64K, the keyboard, the diskette and fixed disk drives, the CRT controller, 
and any nonsystem board hardware. 
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POST tests and initializes the following configuration and nonsystem board 
components in the order listed below: 


CMOS RAM Configuration data 
CRT controllers 

RAM memory above 64K 
Keyboard 

Pointing device (mouse, etc.) 
Diskette drive A availability 
Serial interface circuitry 
Diskette controllers 

Fixed disk controllers 
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Rules for Positioning I/O Expansion ROM 


Introduction 


An |/O expansion ROM is an optional extension of the BIOS which is inserted 
into the machine environment as part of an added I/O subsystem. I/O ROMs 
often replace part of the BIOS for a certain function. (e.g. ESDI fixed disk 
ROM BIOS.) 


I/O expansion ROMs are detected by POST and are given an opportunity to 
initialize themselves and their hardware environment. 


Predefined address ranges 


POST searches for expansion ROM over two predefined address ranges. The 
predefined address ranges are listed in the table below. 


Address Range Description | 
C0000 - C7FFFh VIDEO EXPANSION ROM 
POST searches the address range beginning at CO000h and 
| up to but not Including C8000h for the existence of Video 
Expansion ROM. This search proceeds in 2K increments. 
C8000 - DFFFFh GENERAL EXPANSION ROM 


POST searches the address range beginning at C8000h and 
up to but not Including E0000h for the existence of General 
Expansion ROM. This search proceeds in 2K increments. 
Rules for detecting ROM 
For POST to detect an expansion ROM, the first two words of each expansion 
ROM area must be set up as described below. 


a es Or 
a ROM length in 512-byte blocks 
a ee Entry point for ROM Initialization (via FAR CALL) 


Note: POST calculates the checksum of the area indicated by I/O ROM Byte 
2. If the checksum is zero, POST will call the expansion ROM initializa- 
tion code, which must begin at Byte 3. 


Power-On Self Tests (POST) 115 


Re-entering Real Mode 


Re-entry into real mode 


Several POST processes require that the system be put into protected 
mode. 


When returning to real mode from protected mode, the processor is reset, 
therefore POST is re-entered. In order to prevent re—initialization of the 
system, POST reads the shutdown code stored in location OFh in CMOS 
RAM. It then jumps around the initialization procedures to the appropriate 
entry point. 


Table of shutdown code values 


As POST proceeds, it will use the shutdown codes with values 01h, O2h, 
O3h, 04h, O6h, 07h, and O8h to return the processor to real mode. 


Shutdown codes O5h and OAh are more flexible; they return control to the 
address stored in a double word pointer at 40:67h. These vectors are pro- 
vided for use by operating system extensions such as I/O ROMs. Shutdown 
code 05h flushes the keyboard buffer and performs an end-of-interrupt 
(EOI) prior to vectoring. anicown code OAh simply vectors. 


CMOS RAM 
Location escriplion 


Cee = 


Power-on or soft reset 
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Memory size pass 

Memory test pass 

Memory test fail 

POST end; boot system 

JMP dword pointer with end-of-interrupt 
Protected tests pass 

Protected tests fail 

Memory size fail 

INT 15h Block Move 

JMP dword pointer without end-of-interrupt 


© 
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INT 19h, INT 18h, and System Boot 


Introduction 


Once the POST test and initialization procedures have been completed, POST 
boots the system by issuing an INT 19h. 


INT 19h behavior 
INT 19h behaves as described in the table below: 


a ee ee 
a diskette drive is a bootable diskette is in INT 19h reads the diskette boot 
configured place sector and places its contents 

at address 0000:7CO00h 
a fixed disk is there is no bootable disk- INT 19h reads the fixed disk 
configured ette in the diskette drive boot sector and places its con- 
tents at address 0000:7CO0h 
no boot sector is found | no boot sector is found on} INT 19h issues INT 18h. INT 18h | 


/ on the diskette the fixed disk displays the message: “NO 
BOOT DEVICE AVAILABLE” 


Note: INT 19h performs password checking routines after the boot sector is 
loaded. For more information on INT 19h password checking, refer to 
Chapter 16. 


INT 18h behavior 


INT 18h can be vectored to a “no boot routine” which takes over the boot 
process. An example of such a routine would be one that allows the system 
to be booted over a network. 


By default, the CBIOS initializes INT 18h to point to a routine that displays the 
message: “NO BOOT DEVICE AVAILABLE.” 
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POST Error Handling 


Introduction | 
POST reports test or initialization failures in one of the following ways: 
=» Beep codes 
» System failure messages 
= Boot failure messages 
» Informational messages 


See Appendix A, CBIOS Error Messages, for a complete listing of POST 
messages. | 


118 CBIOS for IBM PS/2 Computers and Compatibles 


7 


Chapter 7 
INT 02h Nonmaskable Interrupt 


Overview 


Introduction 


When the system hardware activates the Nonmaskable Interrupt (NMI) pin on 
the microprocessor: 


» the Central Arbitration Control Point is implicitly disabled and 
# the CBIOS INT 02h NMI interrupt service routine (ISR) is invoked. 


CBIOS NMI Interrupt Service Routine (ISR) 


The CBIOS NMI ISR determines the reason for the NMI and takes appropriate 
action. In general, this involves: 

» explicitly re-enabling the central arbitration control point, 

= displaying a run time error message, and 

» halting the processor. 


Note: NMis can only be cleared by a system reboot. CBIOS supports NMI 


_ clearing by warm (<Ctrl> <Alt> <Del>) reboot or cold reboot (system 
reset button or power switch). 


continued 
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Overview, Continued 


INT 02h vector 


The CBIOS initializes the INT 02h vector to FOOO:E2C3h. The INT 02h vector 
resides at address 00:08h in the CBIOS Interrupt Vector Table. 


In this chapter 


This chapter describes the various NMI sources and tells how the CBIOS 
Nonmaskable Interrupt ISR handles them. 


The following topics are presented: 
» Nonmaskable Interrupt !/O Ports 
» Parity Error NMI Handling 

»® Time-Out Error Handling 

» 80X87 Coprocessor Exceptions 
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Nonmaskable Interrupt I/O Ports 


INT 02h, Nonmaskable Interrupt, references the following I/O ports: 


Read/Write 
1/O Address Status Description 


DMA extended function register, where: 


Bits 7-4 = Progress command, where: 
00h I/O address register 
Oth Reserved 
02h Memory address register write 
03h Memory address register read 
04h Transfer count register write 
05h Transfer count register read 
06h Status register read 
07h Mode register 
08h Arbus register 
09h Mask register set single bit 
OAh Mask register reset single bit 
OBh-OCh Reserved 
ODh Master clear 
OEh-OFh Reserved 

Bits 3-0 = 0 Reserved 


Interrupt controller 1 mask, where: 


Bit 7 0 Enable parallel port 1 interrupt 
Bit 6 0 Enable diskette interrupt 

Bit 5 0 Enable fixed disk interrupt 

Bit 4 0 Enable serial port 1 Interrupt 
Bit 3 0 Enable serial port 2 interrupt 
Bit 2 ; Enable cascade interrupt 
0 


Hh ow on 


Bit 1 Enable keyboard interrupt 
Bit 0 Enable timer channel 0 


Control word register for counter 3 


Bits 7-6 = 00b Select counter 3 
= 01b Reserved 
= 10b Reserved 
= 11b Reserved 
Bits 5-4 = 00b Counter latch command select 
counter 0 
= ee Read/write counter bits 0-7 only 


Bits 3-0 = 00b 


System control port B, where: 
Bit 7 = 1 Parity check 


Bit 6 
Bit 5 
Bit 4 
Bit 3 
Bit 2 
Bit 1 
Bit 0 


1 Channel check 

1 Timer 2 output 

1 Toggles with each refresh request 
0 Channel check enabled 

Parity check enabled 
1 


Speaker data enabled 
Timer 2 gate to speaker enabled 


continued 
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Nonmaskable Interrupt I/O Ports, Continued 


Read/Write 
1/O Address Status Description 


System control port B, where: 


Bit 7 = 1 Reset timer 0 output latch (IRQO) 
Bits 6-4 = Reserved 

Bit 3 = 0 Channel check enabled 

Bit 2 = 0 Parity check enabled 

Bit 1 = 1 Speaker data enabled 

Bit 0 = 1 Timer 2 gate to speaker enabled 


CMOS RAM address register port, where: 


Bit 7 = 1 NMI disable 
= 0 NMI enabled 
Bits 6-O = CMOS address 


Arbitration register, where: 


Bit 7 = 1 Enable system microprocessor cycle 
Bit 6 = 1 Arbitration mask 
Bit 5 = 1 Enable extended arbitration 


Bits 4-0 = 0 Reserved 


= 1 System microprocessor cycle enabled 
Bit 6 = 1 Arbitration mask by NMI 

Bit 5 = 1 Bus time-out 

= 0 Reserved 


System control port A, where: 


Bit 7 = 1 Fixed disk activity light bit A on 
Bit 6 = 1 Fixed disk activity light bit B on 
Bit 5 = Reserved 

Bit 4 1 Watchdog time-out occurred 


Bit 3 = 1 Security lock latch locked 
Bit 2 = Reserved 

Bit 1 = 1 Alternate gate A20 active 
Bit 0 = 1 Alternate hot reset 


Channel position select register, where: 


Bit 7 = 1 Channel 1 reset 
Bits 6-4 = Reserved (written as 0, read as 1) 
Bit 3 = 1 Channel select 


Bits 2-0 = 0 Channel number 
POS register 5 where: 


Bit 7 = 0 Channel check condition occurred 
= 1 Channel reset 
Bit 6 = 0 Channel check exception status 
available 


= 1 No status available 


122 : CBIOS for IBM PS/2 Computers and Compatibles 


Parity Error NMI Handling 


Introduction 


Parity errors in system memory cause system hardware to activate the 
processor’s NMI pin. 


There are two types of memory parity errors: 


=» system board memory failure 
» |/O board memory failure 


Parity error handling in the Phoenix CBIOS 


The table below describes how parity errors are handled by the Phoenix 
CBIOS NMI service, and it suggests possible causes and solutions for each 
error type. 


Error 
Possible Cause Suggested Solution 


Memory Parity Error | Memory is failing. If the Check the system board 
at XXxxx NMI handler can deter- and all installed devices 
mine the address of the for proper operation. 
failing memory, it will be Replace if necessary. 
displayed in place of 
XXXXX. If the failing mem- 
ory is not found, then the 
message will read “Mem- 
ory Parity Error ???7?”. 


1/O Card Parity Error} The peripheral card has Check the system board 
at Xxxx failed. If the NMI handler and all installed devices 
can determine the ad- for proper operation. 
dress of the failing mem- Replace if necessary. 
ory, it will be displayed in 
place of xxxxx. If the fail- 
ing memory is not found, 
then the message will 
read “I/O Card Parity 
Error ??2?”. 


continued 
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Parity Error NMI Handling, Continued 


Parity error handling in IBM PS/2 systems 
IBM PS/2 systems have a different set of error messages. The messages 


it cannot be found. These error codes and messages are listed in the follow- 


ing table. 


a ee System Board Memory Failure : 
111 I/O Channel Check Activated 


Models 25 and 30: IBM PS/2 Models 25 and 30 (and compatibles) support 
memory parity error in the same way as other PS/2 
systems but substitute the message PARITY CHECK1 for 
message 110 and PARITY CHECK2 for message 111. 
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Time-Out Error Handling 


Introduction 


Time-out errors Cause the system hardware to set the processor’s NMI pin. 
There are two kinds of NMi-related time-out errors: 
» Watchdog time-out errors 


» Direct Memory Access (DMA) bus time-out errors 


Watchdog time-out errors 


The watchdog time-out function is enabled via INT 15h, AH = C3h, Watchdog 
Time-Out. 


When enabled, the watchdog time-out function ensures that a program does 
not turn interrupts off for too long a period. It does this by “watching” for a 
missing timer interrupt IRQ 0. (Timer interrupts occur 1024 times per sec- 
ond.) Should a timer interrupt be missed, the watchdog time-out function 
generates an NMI. 


DMA bus time-out errors 
When a DMA driven device uses the bus longer that 7.8 microseconds, the 
Central Arbitration Control Point generates an NMI. 


continued 
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Time-Out Error Handling, Continued 


Time-out and error handling in the Phoenix CBIOS 


The table below describes how the CBIOS NMI ISR handles watchdog and 
DMA bus time-out errors and suggests possible causes and solutions for 
each error type. 


Error 
Possible Cause Suggested Solution 


Watchdog Time-Out The watchdog timer has | Reboot the system. If 
detected that the timer the problem persists, 
0 interrupt has not been | check ail installed de- 
serviced. A program or vices for proper opera- 
device has probably tlon. Replace if neces- 
failed while interrupts sary. If the problem still 
were Off. occurs, examine all 
programs for errors 
which cause the inter- 
rupts to remain off. 


DMA Bus Time-Out Check system board 
and all installed devices 
| for proper operation. 


Replace if necessary. 


A device has driven the 
~BURST signal line for 
more than 7.8 micro- 
seconds, causing the 
central arbiter device 
(on the motherboard) 
to generate a bus 
time-out. 


Time-out and error handling in IBM PS/2 systems 


IBM PS/2 systems have a different set of time-out error messages. They are 
listed in the table below. 


| 2 | Watchdog Time-out 
pt | Direct Memory Access (DMA) Bus Time-Out 


Models 25 and 30: Time-out error handling is not supported on IBM PS/2 
Model 25 and 30 systems. 
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80x87 Coprocessor Exceptions 


How CBIOS maintains compatibility 


Unless it is revectored by a user program, the CBIOS INT 75h ISR is initial- 
ized to the same entry point as INT 02h. This insures that 8087 software 
running under CBIOS is given the opportunity to handle coprocessor excep- 
tions by intercepting INT O2h. 


8087 coprocessor exceptions 


Systems based on the Intel 8088 that incorporate the 8087 math copro- 
cessor indicate math coprocessor exceptions by generating an NMI (i.e. 
INT O2h). 


A coprocessor exception routine should be written to handle 8087 coproces- 
sor exceptions by intercepting INT 02h. The coprocessor exception routine 
should determine if the NMI was generated by the 8087. If the NMI was not 
coprocessor-related, the routine should transfer control to the BIOS NMI ISR. 


80287/80387 coprocessor exceptions 


Systems that incorporate the 80287 or 80387 math coprocessor indicate 
math coprocessor exceptions by setting IRQ 13. IRQ 13 invokes INT 75h, the 
CBIOS 80287/80387 Math Coprocessor Exception. 


A software routine should be written to handle the coprocessor exceptions 
by intercepting INT 75h. The coprocessor exception routine determines if the 
NMI was generated by the coprocessor. If the NMI was not coprocessor- 
related, this routine transfers control to the CBIOS NMI ISR. 


INT 75h vector 


The CBIOS initializes the INT 75h vector to FOO00:E2C3h (i.e. the INT 02h 
entry point). The INT 75h vector resides at address 00:4Bh in the CBIOS 
Interrupt Vector Table. 
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Chapter 8 


INT 09h and INT 16h Keyboard 
Services 


Overview 


Introduction 


The CBIOS contains two keyboard-related services: 


= CBIOS keyboard hardware ISR 
The CBIOS keyboard interrupt service routine (ISR) is invoked via hard- 
ware INT 09h each time a key is pressed. The CBIOS keyboard ISR trans- 
lates System Scan Codes (provided by the 8042 keyboard controller at 
port 60h) into: 


- Updates of the keyboard shift key and toggle key flags 
-— Requests for keyboard ISR internal functions (e.g. Break, Pause, Reset) 
— Entries into the CBIOS keyboard buffer. 


= CBIOS keyboard software DSR 
The CBIOS keyboard device service routine (DSR) is invoked via software 
INT 16h. INT 16h is invoked by the operating system or by application 
programs running under the operating system. The CBIOS keyboard DSR 
contains functions that read the CBIOS keyboard buffer, write to the 
buffer, and return the status of the keyboard service flags. 


continued 
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Overview, Continued 


Vector values 


CBIOS initializes two vectors: 
» INT O9h to point to ROM address FO00:E987h, the IBM—compatible entry 


point. INT O9h resides at address 00:24h in the Interrupt Vector Table, and 


= INT 16h to point to ROM address F0Q00:E82Eh, the IBM-compatible entry 


point. INT 16h resides at address 00:58h in the Interrupt Vector Table. 


In this chapter 


Because they are so closely interrelated, this chapter presents information 
on both INT 09h and INT 16h Keyboard Services. The following topics are 
discussed: 
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Hardware Environment 
Keyboard-to-System Communication 
Keyboard !/O Ports 

System RAM Data 

INT OSh: Internal Function Requests 
INT 16h: Keyboard Services 

How to Read Character Code Tables | 
Character Codes: AH = 00h/01h 
Character Codes: AH = 10h/11h 
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Hardware Environment 


Introduction 


The ROM BIOS supports an intelligent keyboard subsystem based on the 
Intel 8042. 


The hardware interrupt level associated with the CBIOS Keyboard Service 
is IRQ 1. 


The 8042 controller chip 


The Intel 8042 peripheral controller (or compatible) is a single-chip micro- 
computer that can be programmed to allow bidirectional communication 
between the master microprocessor and up to two auxiliary serial input de- 
vices. The 8042 chip, generally, is mounted on the system motherboard. 
8042 programs reside as firmware in the 8042 chip itself. 


Device support 


The kind of devices a given 8042 chip supports are dependent on how the 
8042 is programmed. 


On IBM PS/2-compatible systems, the 8042 is programmed to allow bi- 
directional communication between the system and the keyboard, as well as 
between the system and one other auxiliary serial device, such as a mouse, 
joystick, or trackball. 


Reference 


For more information on the 8042 keyboard controller, refer to Appendix B. 
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Keyboard-to-System Communication 


The diagram below shows how the keyboard communicates with the system. 


Keyboard 

Make/Break Step Il. — 
Scan Codes 

— 8042 

Keyboard 

Controller 

Make/Break 


Internal 
Function 
Requests 


Shift/ 
oggle 
State |< 


INT Oh Step Il. —— 


Flags 


16-Bit 
Character 
Codes 


INT 16h 
84-Key . eres 
Filter ? Step Ill. 
Software 
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Keyboard-to-System Communication, Continued 


Step I. 


8042 Keyboard Controller translates keyboard make or break scan codes into 
make or break System Scan Codes. 8042 System Scan Codes are the only 
codes the INT 09h keyboard service can interpret. 


Step Il. 


INT 09h accepts the System Scan Codes placed at Port 60h by the 8042 
Keyboard Controller and processes each code as follows: 


1. System Scan Codes which correspond to the keyboard shift or toggle 
keys (Shift, Alt, Ctrl, Caps Lock, Num Lock or, Scroll Lock) cause 
INT 09h to update the Shift/Toggle data variables located in segment 40h 
of system RAM. 


. System Scan Codes corresponding to nonshift/toggle keys are first 
compared to the Shift/Toggle state data to see If the shift or toggle of 
the Character Code corresponding to that key should be generated. For 
example, the Character Code for a shifted “A” key Is different from the 
one for an unshifted “a” key. If no shift/toggle state data applies, then 
INT 09h generates the unshifted Character Code for that key. All Charac- 
ter Codes occupy one word and are placed by INT 09h into a 16-word 
keyboard buffer. 


. Some combinations of Shift and Toggle keys (such as Ctrl/Break) and of 
Shift keys and nonshift keys (such as Ctri/Alt/Del) are interpreted by INT 
09h as a request for internal function services. 


Step Ill. 


When invoked by the operating system or by a software application, INT 16h 
acts on the contents of the 16-word keyboard Character Code buffer. If 
desired, character codes can be filtered for compatibility with application 
software that accepts only those character codes generated by 84-key 
keyboards. 
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Keyboard I/O Ports 


INT O9h and 16h Keyboard Services reference the following I/O ports: 


Read/Write 
1/O Address Status Description 


0060h 8042 Data port 
0064h | Rs] 8042 Status port 


System RAM Data 


Introduction 


Throughout the course of operation, the CBIOS keyboard services monitor 
and maintain several status and buffer—control data definitions. 


Keyboard data definitions 


The keyboard data definitions, which are stored in segment 40h of the sys- 
tem RAM, are presented below in offset order. 


ES 


insert active 
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1 

1 Caps Lock active 

1 Num Lock active 

1 Scroll Lock active 
1 Alt pressed 

1 Ctrl pressed 

1 Left Shift pressed 
1 Right Shift pressed 


continued 
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Keyboard data definitions, cont’d 


More keyboard shift flags, where: 


Bit 7 = 1 Insert pressed 
Bit 6 = 1 Caps Lock pressed 
Bit 5 = 1 Num Lock pressed 
Bit 4 = 1 Scroll Lock pressed 
Work area for Alt key and numeric keypad input 
Offset to next character in keyboard buffer 
Offset to first available spot in keyboard buffer 
1Eh 16 Words Keyboard buffer of 16 word entries 
(a maximum of 15 are used at a time) 
Bit 7 = 1 If <Ctri> <Break> pressed 
72h Set to 1234h if <Ctrb> <Alt> <Del> is pressed 


80h 1 Word Address to start of keyboard buffer (from seg- 
ment 40h) 
82h aa to end of keyboard buffer (from segment 


Status byte: 


Bit 7 = 1 Read ID in progress 
Bit 6 = 1 Last code was first ID 
1 Forced Num Lock 

1 101/102 keyboard used 
Right Alt active 
1 
1 


Bit 3 = 1 Ctri-Num Lock state active 
Bit 2 = 1 Sys Req pressed 
Bit 1 = 1 Left Alt pressed 
Bit 0 = 1 Left Ctri pressed 


Right Ctrl active 
Last code was E0Oh 
Last code was Eth 


Status byte: 


Bit 7 = Error flag for keyboard command 
Bit 6 = LED update in progress 

Bit 5 = RESEND received from keyboard 
Bit 4 = ACK received from keyboard 

Bit 3 = Reserved 

Bit 2 = Current status of Caps Lock LED 
Bit 1 = Current status of Num Lock LED 
Bit 0 = Current status of Scroll Lock LED 
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INT 09h: Internal Function Requests 


Introduction 


The CBIOS INT O9h ISR is programmed to interpret certain predefined key 
combinations as requests for internal functions. 


The key or key combinations which the INT O9h ISR interprets as internal 
function calls are listed below: 


<Ctri> <Alt> <Del>: SYSTEM RESET 

<Ctri> <Break> (<Ctril> <Scroll Lock>): BREAK 
<Ctri> <Num Lock>: PAUSE 

<Shift> <Print Screen>: PRINT SCREEN 
<SysReq>: SYSTEM REQUEST 


INT 09h: System Reset (<Ctri> <Alt> <Del>) 


Description 


The CBIOS INT 09h ISR recognizes the <Ctri> <Alt> <Del> key combination as 
an internal request for the system RESET routine. 


The INT O9h ISR invokes the RESET operation with a direct call to the ROM 
BIOS code location where the system RESET routine resides. 


Input/Output 
Input: Keyboard Shift Flags byte (40:17h) 


Bit 3 = 1 (Alt pressed) 
Bit 2 = 1 (Ctrl pressed) 
System Scan Code = 53h (Del pressed) 


Output: Reset Flag word (40:72h) 
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(1 Word) = 1234h 
INT O9h initiates system RESET routine 
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INT 09h: Break (<Ctrl> <Break> or <Ctrl> <Scroll Lock>) 


Description 


The CBIOS INT O9h ISR recognizes the <Ctril> <Break> key combination as an 
internal function request for INT 1Bh. <Break> and <Scroll Lock> are equiva- 
lent keys on many keyboards. 


INT 1Bh DSR is simply a vector which points to a body of programmer-— 
created or application—-program-resident code intended for execution when 
the <Ctril> <Break> key combination is received from the keyboard. 


Input/Output 


Input: Keyboard Shift Flags byte (40:17h): 
Bit 2 = 1 (Ctrl pressed) 
System Scan Code = 46h (Break pressed) 


Output: INT O9h invokes INT 1Bh, a vector address which points to a break 
routine, if any. 
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INT 09h: Pause (<Ctri> <Num Lock>) 


Description 


The CBIOS INT O9h ISR recognizes the <Ctrl> <Num Lock> key combination 
as an internal function request for the INT 09h controlled PAUSE state. On a 
101-key keyboard, the <PAUSE> key causes the INT 09h ISR to initiate the 
Pause State. 


When the INT 09h ISR puts the computer system into the Pause State, the 
INT O9h ISR Pause-State routine loops until a valid key or key combination is 
received from the keyboard. 


Input/Output 


Input: Keyboard Shift Flags byte (40:17h) 
Bit 2 = 1 (Ctrl pressed) 
Keyboard Shift Flags byte 2 (40:18h) 
Bit 5 = 1 (Num Lock pressed) 
Bit 3 = 1 (Ctri/Num Lock in active state: suspend toggles) 
System Scan Code = 45h (Num Lock pressed) 


Output: INT OSh loops PAUSE routine until a valid key or key combination 
| is received from 8042 controller. 


Ending PAUSE state 


To end Pause State, Bit 3 of Keyboard Shift Flags byte 2 (40:18h) must be 

reset to 0. 

The INT O9h ISR resets Bit 3 of Keyboard Shift Flags byte 2 to zero as soon 

as it receives: | 

1. The make System Scan Code for any non-shift key except the SYS REQ 
key, or 

2. Any valid shift/toggle key combination. 


The valid shift/toggle key combinations needed to reset Bit 3 of Keyboard 
Shift Flags Byte 2 to zero are shown on the following page. 


continued 
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INT 09h: Pause (<Ctri> <Num Lock>), Continued 


PAUSE state table 


The table below outlines the behavior of the various shift/toggle key combi- 
nations during the INT 09h ISR pause state. The key combinations necessary 
to reset Bit 3 of Keyboard Shift Flags Byte 2 to zero (i.e. end Pause State) 
are in category #1. 


kx a 
Shift phi Kaye Toggle Keys 


Caps Lock Scroll Lock Num Lock 


Shite on! or R) 
Ait/Shitt 


Ctrl/ | Ss 


Alt/Ctrl 
Ait/Ctri/Shift 


LEGEND 


1. PAUSE STATE IS ENDED (Bit 3 of Keyboard Shift Flags Byte 2 is reset). 
The scan codes normally associated with these keys do not have their 
usual effect on the shift and toggle flags. They are interpreted instead as 
a request to reset Bit 3 of Keyboard Shift Flags Byte 2 to zero, thus 
ending the Pause State. 


2. PAUSE STATE IS NOT ENDED. The 8042 controller chip places the System 
Scan Code for (ins) or (Shift Ins) into its internal buffer. The INT OSh ISR 
will act on these codes once Pause State is ended. 


3. PAUSE STATE IS NOT ENDED. These key combinations are treated as 
valid requests to change Shift/Toggle states or update LEDs. 


4. PAUSE STATE IS NOT ENDED. The keys which initiate the Pause State can 
not be used to end Pause State. When in Pause State, these keys are 
ignored. 


5. PAUSE STATE IS NOT ENDED. When in Pause State, these keys are 
ignored. 
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INT 09h: Print Screen (<PrtSc> or <Shift> <PrtSc>) 


Description 


The CBIOS INT OSh ISR invokes INT O5h (the CBIOS Print Screen service) 
whenever it receives the combination of System Make Scan Codes corre- 
sponding to the left or the right Shift key and the Print Screen key. 


The System Make Scan Codes necessary to cause INT 09h to invoke INT O5h 
can be generated in either of the ways listed below: 

1. By pressing the Print Screen key alone, or 

2. By pressing either of the Shift keys and the Print Screen key. 


Input/Output 
Input Case #1: <PriSc> key only 
Input Case #2: <Shift> <PrtSc> keys 
System Scan Codes = EOh, 2Ah, EOh, 37h 
(Left Shift and Print Screen both depressed) 


Keyboard Shift Flags Byte (40:17h) 
Bit 1 = 1 (Left Shift pressed) 
or 
Bit O = 2 (Right Shift pressed) 
System Scan Codes = EOh, 37h 
Output for both Case #1 and Case #2: 
INT OSh invokes INT 05h BIOS Print Screen Service 
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INT 09h: System Request (<SysReq>) 


Description 


The CBIOS INT 09h ISR interprets the System Request key in either of two 
ways: 


» When the System Request key is depressed, INT O9h interprets the result- 
ing System Scan Code as an internal function request for INT 15h: func- 
tion AH = 85h, subfunction AL 00h — Process System Request. 

» When the System Request key is released, INT O9h interprets the resulting 
System Scan Code as an internal request for INT 15h, function AH = 85h, 
subfunction AL = 01h — Terminate System Request. 


Process SysReq input/output 


The inputs and outputs that result when the System Request key is pressed 
are listed below: 
Input: Keyboard Shift Flags Byte 2 (40:18h) 
Bit 2 = 1 (System Request pressed) 
Output: AH = 85h 
AL = OOh 
INT O9Sh invokes INT 15h Process System Request 


Terminate SysReq input/output 


The inputs and outputs that result when the System Request key is released 
are listed below: 
Input: Keyboard Shift Flags Byte 2 (40:18h) 
Bit 2 = O (System Request key released) 
Output: AH 85h 
AL = Oth INT O9h invokes INT 15h Terminate System Request 
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INT 16h: Keyboard Services 


introduction 


The CBIOS keyboard services are invoked via software interrupt INT 16h. In- 
dividual function codes are selected via the AH register. 


Summary of INT 16h functions 


A table of INT 16h AH register values and their corresponding function is 
shown below. 


Description 


[08n | Set Typomato Rate and Belay 
a 
[ton | "Read extended Key heat 
[12m | Retr Extondes Sit Fags Status 
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INT 16h: AH = 00h Read Keyboard Input 


Description 
The Read Keyboard Input function executes as follows: 


= If a character code is available in the keyboard buffer, this function reads 
the character code and returns its value in AX. 


» |If the keyboard buffer is empty, this function suspends program execution 
until a character code is inserted into the buffer. 


» If the keyboard LEDs do not match the current flag settings, this function 
updates the LEDs. 


Input/Output 
Input: AH = OOh 
Output: AH = Scan code or character ID for special character 
AL = ASCII code or other translation of character. 


84-key “filtering” 


The read keyboard input function acts as an 84-key keyboard filter, selec- 
tively editing the buffer contents for 84-key keyboard compatibility. 

When a 101-key keyboard is in place, INT 16h function AH = OOh: 

=» Returns all standard 84-key keyboard Character Codes as is, 


» Adjusts 101-key keyboard duplicates of 84-key keyboard characters so 
that they take on the same two-byte key code as their 84-key counter- 
parts, and 


=» Destroys any 101-key Character Codes not compatible with the 84-key 
keyboard. 


Note: The data table labeled “Character Codes: AH = O0Oh/Oth” lists the 
codes returned when using INT 16h AH = OOh and AH = Oth. 


Reference 


Function AH = 10h Read Extended Keyboard Input does not modify character 
codes for 84-key keyboard compatibility. For further details, see the 
Function: AH = 10h heading in this chapter. 
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INT 16h: AH = 01h Return Keyboard Status 


Description 


This function is useful for allowing programs to check for keyboard input 
while continuing to run if there is none. It executes as follows: 


Checks to see if a two-byte character code is available in the keyboard 
buffer. 


If a key is waiting, a copy of the key is returned. The buffer is not incre- 
mented to the next key. 


If the keyboard buffer contains at least one key, the Zero Flag is cleared. 
If the keyboard buffer does not contain a key, the Zero Flag is set. 


If the keyboard LEDs do not match the current flag settings, this function 
updates the LEDs. 


Input/Output 
input: AH = Oth 
Output: AH = Scan code or character ID for special character 
AL = ASCII code or other translation of character. 
ZF = OQ Character is ready 


1 No character is available 


tively editing the buffer contents for 84-key keyboard compatibility. 


When a 101-key keyboard is in place, INT 16h function AH = Oth: 


Returns all standard 84-key keyboard Character Codes 4s is, 


Adjusts 101-key keyboard duplicates of 84-key keyboard characters so 
that they take on the same two-byte key code as their 84-key counter- 
parts, and 


Destroys any 101-key Character Codes not compatible with the 84-key 
keyboard. 


Note: The data table labeled “Character Codes: AH = 00h/01h” lists the 


codes returned when using INT 16h AH = OOh and AH = Oth. 


144 


continued 
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INT 16h: AH = Oth Return Keyboard Status, Continued 


Reference 


Function AH = 11h Return Extended Keyboard Input does not modify charac- 
ter codes for 84-key keyboard compatibility. For further details, see the 
Function: AH = 11h heading in this chapter. 


INT 16h: AH = 02h Return Shift Flag Status 


Description 


The Return Shift Flag Status function returns the current shift status from the 
Keyboard Shift Flags byte (40:17h). The LED status is not updated. 


Input/Output 
Input: AH = OQ2h 
Output: AL = Current shift status, where: 


Bit 7 = 1 Insert active 

Bit 6 = 1 Caps Lock active 
Bit 5 = 1 Num Lock active 
Bit 4 = 1 Scroll Lock active 
Bit 3 = 1 Alt pressed 

Bit 2 = 1 Ctrl pressed 

Bit 1 = 1 Left Shift pressed 
Bit O = 1 Right Shift pressed 


—, 
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Int 16: AH = 03h Set Typematic Rate and Delay 


Description 


The Set Typematic Rate and Delay function changes the typematic rate 
(make code per second) and the delay. 


Input/Output 


If the parameters are valid, the function transmits a Set Rate command 
(F3h) to the keyboard controller. 


Input: AH = QO3h 
AL = Q5h 
BH = Delay (00h —- 03h) 
BL = Typematic rate (OOh — 1Fh) 


Output: None 


INT 16h: AH = 04h Reserved 
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Function: AH = 05h Store Key Data 


Description 


The Store Key Data function stores program-generated data into the Key- 
board buffer just as if a key were pressed. The buffer pointer (40:1Ch) is 
adjusted to point to the next available location in the keyboard buffer. 


lf the Keyboard buffer is full, AL is set to indicate a keyboard buffer full 
error. 


Input/Output 


Input: AH = O5h 
CH = Scan code 
CL = ASCII character 


Output: AL = OOh No error 
= Q1h Keyboard buffer full 


Note: Keyboard enhancers and other utilities can use this function to inter- 
polate keys into the data stream viewed by applications programs. 


INT 16h: AH = 06h - 09h Reserved 
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INT 16h: AH = 10h Read Extended Keyboard Input | 


Description 


The Read Extended Keyboard Input function reads the next two-byte charac- 
ter code in the keyboard buffer and returns the value in AX. It is designed 
for use with the 101/102-key keyboard. Unlike function AH = OOh, this func- 
tion does not modify character codes for 84~key keyboard compatibility. 


Input/Output 
Input: AH = 10h 
Output: AH = Scan code or character ID for special character 
AL = ASCII code or other translation of character 


Note: The character codes returned by this function are found in the table 
“Character Codes: AH = 10h/11h” in this chapter. 


FOh low byte filter 


INT O9h places the value FOh in the low byte character code position for 
some Alt/character key combinations. The Return Extended Keyboard Input 
function strips FOh from the keyboard buffer image before returning to the 
caller. Keys with FOh are returned to AX with their low order byte set to OOh. 


All other keys are returned to AX unmodified by this function. 


Reference 


Function AH = 00h Read Keyboard Input selectively filters keyboard buffer 
input for compatibility with 84-key keyboards. For details, see the Function: 
AH = 00h heading in this chapter. | 


148 | CBIOS for IBM PS/2 Computers and Compatibles 


INT 16h: AH = 11h Return Extended Keyboard Status 


Description 


This function is similar to function AH = O1h, except that it returns unique 
scan codes for all keys on the 101/102-key keyboard. It executes as follows: 


Checks to see if a character code is available in the keyboard buffer. 


If a key is waiting, a copy of the character code is returned in AX. The 
buffer is not incremented to the next key. 


lf the keyboard buffer contains at least one key, the Zero Flag is cleared. 
lf the keyboard buffer does not contain a key, the Zero Flag is set. 


If the keyboard LEDs do not match the current flag settings, this function 
updates the LEDs. 


Input/Output 
Input: AH = 1th 
Output: AH = Scan code or character ID for special character 
(if ZF is set) 
AL = ASCII code or other translation of character ID (ZF is set) 
ZF = QNo key in buffer 
= 1 Key waiting 


FOh low byte filter 


INT OSh places the value FOh in the low byte character code position of 
some Alt/character combinations. The Return Extended Keyboard Status 
function strips FOh from the keyboard buffer image before returning to the 
caller. Keys with FOh are returned to AX with their low order byte set to OOh. 


All other keys are returned to AX unmodified by this function. 


Note: The character codes returned by this function are found in the table 


“Character Codes: AH = 10h/11h” in this chapter. 


Reference 


Function AH = O1h Read Keyboard Status selectively filters keyboard 
buffer input for compatibility with 84-key keyboards. For details, see 
“Function: AH = 01h” in this chapter. 
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INT 16h: AH = 12 Return Extended Shift Flags Status 


Description 


This function is similar to function AH = 02h, except that it returns informa- 
tion on the shift keys provided on the 101/102-key keyboard. It also returns 
an additional byte of flags in the AH register. 


The Return Extended Shift Flags Status function returns the shift flag status 
from Keyboard Shift Flags Byte (40:17) in the AL register, and returns the 
shift flag status from Keyboard Shift Flags Byte 2 (40:18) and 101-key Key- 
board Status Byte (40:96) in the AH register. 


Input/Output 
Input: AH = 12h 
Output: AH = More keyboard shift flags, where: 


Bit 7 = 1 Sys Req pressed (40:18h Bit 2) 
Bit 6 = 1 Caps Lock active (40:18h Bit 6) 
Bit 5 = 1 Num Lock active (40:18h Bit 5) 
Bit 4 = 1 Scroll Lock active (40:18h Bit 4) 
Bit 3 = 1 Right Alt active (40:96h Bit 3) 
Bit 2 Right Ctrl active (40:96h Bit 2) 
Bit 1 Left Alt active (40:18h Bit 1) 

Bit O = 1 Left Ctrl active (40:18h Bit 0) 


AL = Keyboard shift flags (copy of Keyboard Shift Flags Byte 
40:17), where: 


nou | 
aml 


awh, 


Bit 7 = 1 Insert active 

Bit 6 = 1 Caps Lock active 
Bit 5 = 1 Num Lock active 
Bit 4 = 1 Scroll Lock active 
Bit 3 = 1 Alt pressed 

Bit 2 = 1 Ctrl pressed 

Bit 1 = 1 Left Shift pressed 
Bit O = 1 Right Shift pressed 


INT 16h: AH = 13 - FFh Reserved 
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How to Read Character Code Tables 


introduction 


The tables on the following pages present data related to the IBM PS/2- 
compatible keyboard. 


There are two character-—code tables. They are labeled: 
=» Character Codes: AH = 00h/0Oth 
s Character Codes: AH = 10h/11h 


How to read the tables 


» The data presented in each table is listed according to key number. 
These key numbers serve as a legend for identifying the keys. They have 
no relationship to Keyboard Scan Codes, System Scan Codes, or to Char- 
acter Codes. See the keyboard layout figure on the next page for a map 
of these key numbers. 


« The tables list Keyboard Scan and System Scan Codes by make code 
only. Break codes are found by adding a value of 80h to the make code 
in question. 


» The two-byte number associated with each Character Code is listed in 
four-digit hex notation. The high order byte, which is placed by INT 16h 
into the AH register, is listed first. The low order byte, which is placed by 
INT 16h into the AL register, is listed second. The two bytes are sepa- 
rated with a slash. For example, the Character Code for the unshifted “n” 
key is listed on the table as 31/6E. 


=» Caps Lock plus any typewriter key yields the same character code as 
Shift plus any typewriter key. 


» Num Lock plus any numeric keypad key yields the same character code 
as Shift plus any numeric keypad key. 


« Alt plus the decimal value for an ASCII character input from the numeric 
keypad yields the ASCII character. Allowable values are 0 to 255. These 
instances are noted with “**” in the Alt column. 


continued 
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How to Read Character Code Tables, Continued 


_ Keyboard layout | 
The figure below depicts the key arrangement and key number system 
applied to the typical 101-key keyboard. 


Cl A a Eo aie 


@ # $ I % : + : 
= 
> —p| 


Print Scroll 
weak 


Entre gc @Y“Y §@°" gg“ 2" BY FF Fe ge. 8 , Bo | Enter 
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Character Codes: AH = 00h/01h 


Introduction 


The read keyboard input function acts as an 84-key keyboard filter, selec- 
tively editing the buffer contents for 84—key keyboard compatibility. 


When a 101-key Keyboard is in place, INT 16h subservice AH = OOh: 


» Returns all standard 84-key keyboard Character Codes “as is,” 

»s Adjusts 101—key keyboard duplicates of 84-key keyboard characters so 
that they take on the same two-byte key code as their 84—-key counter- 
parts, and 

= Destroys any 101-key Character Codes not compatible with the 84—key 
keyboard. 


Table: AH = 00h/01th 
The table below lists the character codes returned by functions AH = OOh 
and AH = Oth. 


Make Codes (hex) Character Codes AH/AL (hex) 


devec ean | 
aes 
ee feet fy 78/00 
a 7B/00 


08/37 08/26 7E/00 
7F/00 


—— 
“oo — 

ae we 

at ee 


continued 


aah, 


= ok 
oO 
a 
~J f 
oO 
~“ 
_~ 
oe 
oO) 
(>) 
N“N 
~ 
on 
m 
(>) 
N 
~~ 
—_ 
m 


GW 
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Character Codes: AH = 00h/01h, Continued 


Table: AH = 00h/0th, cont’d 


U.S. Make Codes (hex) Character Codes AH/AL (hex) 
Keyboard 


" [iret [ aire 00 


2B/5C 2B/7C 2B/1C 
1E/61 1E/41 1E/01 1E/00 
1F 1F/73 1F/53 1F/13 1F/00 
7 


oe es 
Orn 


27 


ar ae a ae 
ee ae 
(101-key 
only) 
Caps Lock | 58 


2400 


2B/5C 2B/7C 2B/1C 


continued 


G 
~“N 
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Character Codes: AH = 00h/01h, Continued 


Table: AH = 00h/0th, cont’d 


U.S. Make Codes (hex) Character Codes AH/AL (hex) 
Keyboard 
Legend Keyboard | system | Normal | Shifted Control Alt 


only) 
re 
_ sz | 
re 


44 
45 


2C/00 
2D/00 
2E/00 
2F/00 
30/00 
31/00 
32/00 


Z 
[a [| sence | sarc 
[aa [saver | aser ] 
co [| =» | | | 
a OC 
ee 
Teo | e038 
E01 


> 
~“N < 
tt 


e- 
© 


< 
.> | 
R Shift 


a) 
; 


~ 
~" 


E0-11 


asl 
ne 
a 


aes 
a 
weer | —e0-70|e0-s2 [sare | eermo[ 
[peste | e0-71 | e0-ss| sare | ssro | 


3A 

4A 
(ens eo-e [cour | arroo | F700 | 78/00 
[te [ee 


EO 

EO 

ew | eve | eos | sore | somo | 
e008 
eos 


57 
64 
75 
76 
79 
84 


4 
49/00 49/00 84/00 
51/00 51/00 76/00 


Page Up E0-7D 
Page Down E0-7A 


continued 
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Character Codes: AH = 00h/01h, Continued 


Table: AH = 00h/01h, cont’d 


U.S. Make Codes (hex) Character Codes AH/AL (hex) 
nevroe a 


Key id 
89 


“at 
Oo 
i | 
> 
m 
7 
ik 
O 
> 
O 
~ 
2) 
oO 
> 
O 
~ 
Oo 
i 
™N 
BN 
— 
=] 
t 


3 
aoe 
| 48 | 4av00 | 47e4 | 79/00 
LaF | 4Fvoo | a7is1_ | 75/00 
ee ees 
_ 48 | 4evoo | see | 
te ete 
80 
a 
7 
oe 
| 4D 
La 


N 


[sero | serso[ 
Taran _| aren | 
[siv00 | sivas [76700 
Oe 
[ve | 48 [sare [aa | 
a 
[torsos [ovis 

ak ae 
ee 
ss | a 
ee 


105 


108 


—_ 
—_ 
© 


_ 
—_ 
oo 
ie) 


** Alt plus the decimal value for an ASCII character input from the numeric keypad yields 
the ASCII character. Allowable values are 0 to 255 


continued 


wash 
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Character Codes: AH = 00h/01h, Continued 


Table: AH = 00h/01h, cont’d 


Make Codes (hex) Character Codes AH/AL (hex) 


[|| vero | sero | esr00 | 70/00 
[ee [4 | aaro0 | s0/00 | 67100 | 71700 
oe eo 


78 57 


52 ee ee 


Print E0-12/ E0-2A/ 
Screen E0-7C E0-37 
E0-37 


FRE TE 
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Character Codes: AH = 10h/11h 


Introduction 


INT O9h places the value FOh in the low byte character code position for 
some Alt/character key combinations. The Return Extended Keyboard Input 
function strips FOh from the keyboard buffer image before returning to the 
caller. Keys with FOh are returned to AX with their low-order byte set to OOh. 


All other keys are returned to AX unmodified by this function. 


Table: AH = 10h/11h 


The table below lists the character codes returned by functions AH = 10h 
and AH = 11h. 


U.S. 
Keyboard 
Legend 


ee ee 
ee 
[08 | osrse | osr40 | aaroo | 70/00 
To [eaves [owas |__| 7a/00_ 
[05 | osrsa | osree |_| 78700 | 
[06 | osras | osras |_| 70700 
[or | ovrae | arise | anne | 70700 
= 
= 
ac ae 
a 
a 


Towra [owas |_| 7700 
oerse | oorza |_| 7700 
Teneo | one |_| #0700 
Toara0 | ose |_| #1700 
es a 

Foe0e | ogre | ere | 
[or [erie [oro [i 


continued 
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Character Codes: AH = 10h/11h, Continued 


Table: AH = 10h/11h, cont’d 


Make Codes (hex) Character Codes AH/AL (hex) 


a 
2 
a 
= 


U.S. 
Keyboard 


Key # 


N 
BS 


18/0F 18/00 
19/10 | 19/00 
1A/1B | 1A/00 | 
| 1B/SD | 1B/7D | 1B/1D | 1B/00 | 


2B/5C 2B/7C 2B/1C 2B/00 


aa 
pte tever | teat | tev01 
pF | trv7a_ | iris | 1F/13 
| 20 | 2064 | 20/44 | 20/04 
| at | ates | 214s | 21/06 
| 22 «| ave7 | 22/47 22/07 
Rt ee 
4 
L = tees 
| 6 | 
a7 
a 
1 


1 


—_ 
~N 


ee 
(101-key 
only) 


Caps Lock 


1E/00 
1F/00 
20/00 
21/00 
22/00 
23/00 
24/00 
25/00 
26/00 
27/00 
28/00 


1 


2B/5C 2B/7C 2B/1C 


7 
A 
A 
1C 
F 
37 
4C 27 


pA | ic 
a ae 
re 
a ee 
ae a ae 


(102-key 
only) 


10/00 


continued 
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Character Codes: AH = 10h/11h, Continued 


Table: AH = 10h/11h, cont’d 


U.S. Make Codes (hex) Character coger AH/AL (hex) 


Keyboard 
Legend — 


2C/00 


Le _| 
2 
os _ 
Tos 


a a 
Tawae [ewe |_| 
Tasar_[aser | 
ee 
To | |_| _ 
co | | | i 
oe 
ee 
Tew | | | id 
Se eee 
[ess [sero | s00 [e070] 


E0-48 48/00 48/00 E0/8D 


oOirn 
oO; © 


BS 


Page Up 


continued 
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Character Codes: AH = 10h/11h, Continued 


+ 
0) 
o 
© 
> 
B a 


= 10h/11h, cont’d 


U.S. Make Codes (hex) Character Codes AH/AL (hex) 
Keyboard 
Right E0-74 E04 | 4D/00 4D/00 74/00 9D/00 
cs [| | | 
| 47 | 47/00 47/37 77/00 


[Heme [eo 
| 69 4F/00 47/31 75/00 


“7 E0-4A 35/2F 35/2F 95/00 A4/00 


Key # 


8 UP | 48 | 48/00 58/38 8D/00 
i. tee 40/00 4C/35 8F/00 


2 Down 


a 50/00 50/32 91/00 


52/00 52/30 92/00 
37/2A 37/2A 96/00 37/00 
49/00 49/39 84/00 ak 


—_ 
oO 
Oo 


a = [eee [ae 


a 
| 88 
Le 
oe 
ie oe ee 
cae 
ee 
ae 
| ae 


_ 
_ 
Oo 


nN 
ed 


nN 
orn >} Gi] MY 


113 


qn 


115 
116 
117 


Ee 
FS 
F 


** Alt plus the decimal value for an ASCII character input from the numeric keypad yields 


n 
oO) 


119 


}7 


the ASCII character. Allowable values are 0 to 255. 


continued 
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Character Codes: AH = 10h/11h, Continued 


Table: AH = 10h/11h, cont’d 


Make Codes (hex) Character Codes AH/AL (hex) 
Keyboard 
43/00 5C/00 66/00 70/00 
44/00 5D/00 67/00 71/00 


85/00 57/00 89/00 8B/00 
rasve0 | 57700 | 60/00 | 08/00 


Print E0-12/ 
Screen E0-7C 
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Chapter 9 
INT 10h Video Service 


Overview 


Description 


The CBIOS Video Service provides |/O support for both color and mono- 
chrome analog video monitors and supports selection of display mode, 
Cursor addressing, text display, scrolling, and writing pixels. 


A significant advantage of the CBIOS Video Service is that most routines can 
be called by the user program regardless of the video mode being used 
(monochrome, CGA, EGA, or VGA). The CBIOS Video Service offers all the 
features and functions of the VGA BIOS. The video services themselves find 
Out what the current type of display is and take care of whatever address 
translation is needed, including getting bit patterns from an in-memory table 
font if the user’s program asks for text display in graphics mode. 


How the services are invoked 
INT 10h invokes the CBIOS Video Service. 


The INT 10h vector resides at Interrupt Table Address 00:40h. To ensure 
compatibility, the CBIOS initializes the INT 10h Video Service vector to 
absolute address FFO65h. 


continued 
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Overview, Continued 


How the services are invoked, cont’d 


Individual Video Service functions are selected via the AH register. If the 
number in AH is outside the legal range, no action will be taken. Subfunct- 
ions are selected via the AL register or the BL register. The following general 
rules apply to these services: 


=» The character or pixel value that is to be written is normally passed in 
register AL. 


= BX, CX, DX and segment registers are preserved through all service 
calls. Assume that all other register contents, particularly SI and DI, may 
be destroyed. 


» The x coordinate (column number) is passed in CX (graphics functions) or 
DL (text functions). 


» Any display page value is passed in BH. Display pages are zero—based 
(i.e., page O = first page, page 1 = second page, etc.). 


- continued 
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Overview, Continued 


Summary of video service functions 


The table below summarizes the Video Service function and subfunctions. 


AH Description 


Set Video Mode 
Oth 
02h Set Cursor Position 


Set Cursor Type 


Read Current Cursor Position 
Read Light Pen Position 
Select New Video Page 
Scroll Current Page Up 


Scroll Current Page Down 


Read Character/Attribute to Screen 


Poth —_—*| Read ght Pen Postion 
a ee Write Character/Attribute from Screen 


Write Character Only to Screen 


pemoteemreenge: 


Set Color Palette 


Set Palette Registers 


AL = 00h Set single palette 
* AL = Oth Set overscan register 
* AL = 02h Set all palette registers and overscan 
AL = 03h Toggle intensity/blinking bit 
AL = 04h-06h Reserved 
* AL = 07h Read individual palette register 
AL = 08h Read overscan register 
AL = 09h Read all palette registers and overscan register 
AL = 10h Set individual color register 
AL = 11h Reserved 
AL = 12h Set block of color registers 
* AL = 13h Select color paging mode (not valid for mode 13h) 
BL = 00h Select paging mode 
BL = Oth Select page 
* AL = 14h Reserved 
AL = 15h Read single DAC color register 
AL = 16h Reserved 


* Not supported on IBM PS/2 Models 25 and 30 (and compatibles) with MCGA hardware. 


continued 
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Overview, Continued 


Summary of video service functions, cont’d 


10h Set Palette Registers, continued 


(cont’ d) AL = 17h Read block of color registers 
AL = 18h-19h Reserved 
* AL = 1Ah Read color paging status 
AL = 1Bh Sum color values to gray shades 


Character Generator 
AL = 00h Load user text mode font 
AL = 01h Load ROM 8x14 text mode font 
| AL = 02h Load ROM 8x8 double dot font 
: AL = 03h Set block specifier (text modes only) 
AL = 04h Load ROM 8x16 text mode font 
* AL = 10h Load user text mode load (after mode set) 
* AL = 11h Load ROM 8x14 text mode font (after mode set) 
* AL = 12h Load ROM 8x8 double dot text mode font (after 
mode set) 
AL = 14h Load ROM 8x16 text mode font (after mode set) 
AL = 20h Set user graphics characters pointer at INT 1Fh 
(8x8 font) 
AL = 21h Set user graphics characters pointer at INT 43h 
* AL = 22h Load ROM 8x14 font for graphics 
AL = 23h Load ROM 8x8 double dot font for graphics 
AL = 24h Load ROM 8x16 font for graphics 
AL = 30h Get font pointer information 


Alternate Select 


* BL = 10h Return VGA information 
BL = 20h Switch to alternate print screen routine 
* BL = 30h Select scan lines for text modes 
BL = 31h Enable/disable default palette loading during set 


mode 
BL = 32h Enable/disable video 
BL = 33h Enable/disable summing to gray shades 
* BL = 34h Enable/disable cursor scaling 
BL = 35h Switch display 
* BL = 36h Video screen off/on 


Write String 


AL = 00h Cursor not moved 
AL = 01h Cursor is moved 

AL = 02h Cursor not moved (text modes only) 
AL = 03h Cursor is moved (text modes only) 


14h-19h 


Read/Write Display Combination Code 


AL = 00h Read display combination code 
* Not supported on IBM PS/2 Models 25 and 30 (and compatibles) with MCGA hardware. 


AL = 0th Write display combination code 


continued 
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Overview, Continued 


Summary of video service functions, cont’d 


Return Functionality/State Information 


Save/Restore Video State* 
* AL = 00h Return Save/Restore buffer size needed 


* AL = Oth Save current video state 
* AL = 02h Restore current video state 


* Not supported on IBM PS/2 Models 25 and 30 (and compatibles) with MCGA hardware. 


In this chapter 
This chapter focuses on the Video Service. The following topics are 
presented: 
=» Hardware Environment 
= Video i/O Ports 
=» Video Modes 
= Mode/Monitor Support 
= ROM Character Generators 
=» System RAM Data 
» Video Service Functions 
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Hardware Environment 


introduction 


The CBIOS Video Service assumes the following hardware environment: 
# IBM VGA-compatible VLSI chip or chip set 

» INMOS G171 or compatible digital-to—-analog converter (DAC) chip 

» 256K of dynamic read/write video RAM configured as four 64K maps 
# Monochrome or color direct drive analog monitor 


VGA-compatible chip (or chip set) 


168 


The VGA chip (or chip set) provides all CRT control signals. It consists of 
four components: CRT Controller, Sequencer, Graphics Controller, and 
Attribute Controller. 


In general, the VGA-compatible chip provides the interfacing between the 
system microprocessor and video memory, provides all of the CRT control 
signals, and outputs 8-bit digital data to the Digital-to—Analog converter for 
display. 


Each of these components contains a fixed number of control registers that 
are accessed via 8-bit I/O ports. The CBIOS exchanges information with 
control registers by writing the register number to the appropriate |/O port 
and by subsequently reading from or writing to the specified register. 


continued 
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Hardware Environment, Continued 


Table of VGA component functions 


The function of each VGA component is summarized in the table below. 


Function CRT Controller 


CRT Controller Generates horizontal and vertical CRT sync timings, cursor 
and underline timings, video buffer addressing, and refresh 
addressing. 


Sequencer | Arbitrates system access to display RAM and fonts. The 
sequencer allows up to eight fonts with two fonts display at 
any one time. 

Graphics Controller Handles read/write operation on four parallel bit planes. Out- 

| puts data to Attribute Controller. 


Attribute Controller | Converts incoming text mode attribute data or graphics 
mode pixel data into 8-bit indexes into the Digital-to—-Analog 
Converter (DAC) color registers (see below). 


Digital-to-Analog Converter (DAC) 


The video DAC contains 256 individual color registers which can be accessed 
by the CBIOS as either four 64-color registers or sixteen 16-color registers. 


Each DAC color register contains one 18-bit RGB analog value. Six bits of 
each register are allocated to each primary color. Thus, the color repre- 
sented in each DAC color register may be any of 256K possible colors 
(i.e. 29*6 = 256K). | 


continued 
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Hardware Environment, Continued 


DAC, Attribute controller, BIOS initialization 


The CBIOS initializes the 8—bit index values contained in the Attribute Control- 
ler and the 18-bit analog color values contained in the DAC color registers 
each time a video mode is set. 


The table below outlines the DAC/Attribute Controller relationship for the 
three major types of video modes. 


Mode interrupt/initialization table 


EGA and 
16-color VGA 


DAC 


The CBIOS initializes access to the 256 DAC color registers in 
blocks, or pages, of 64 colors each. The first 64-color page is in- 
itialized to analog equivalents of the 64 EGA colors. The other 192 
colors remain undefined. 


Attribute Controller 


To maintain color compatibility with existing EGA software, CBIOS 
initializes the Attribute Controller to the 16 commonly accepted 
default EGA colors. 


DAC 


The CBIOS initializes access to the 256 DAC color registers as four 
blocks of 64 colors each in CGA modes. The first 64-color block is 
initialized as four 16-color sub-blocks. Each of these 16-color 
blocks is initialized to the 16 colors displayable in CGA mode. The 
remaining 192 DAC registers are undefined. 


Attribute Controller 


To maintain color compatibility with existing CGA software, the 
CBIOS initializes the Attribute Controller to the 16-color CGA pal- 
ette. When applications software requests a CGA color, the Attrib- 


ute Controller maps the requests through to its analog equivalent in 
the DAC controller. 


DAC 


The CBIOS initializes all 256 color registers to their IBM PS/2 
default equivalents. 


Attribute Controller 


The attribute controller receives 8-bit color values directly from 
applications programs. It maps those values directly Into the DAC 
color registers. 


Note: For more information on the CBIOS Video Service video modes, refer 
to the Video Modes page heading in this chapter. 
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Hardware Environment, Continued 


Video RAM 


The CBIOS Video Service requires 256K of read/write video RAM formatted 
into four banks (or maps) of 64K. 


To maintain compatibility, display memory for each of the historical MDA, 
CGA, and EGA modes is exactly as it was before. The display memory 
organization for the new VGA modes is outlined in this chapter in the table 
found under the Video Modes heading. 


Analog monitor support 


To display all modes, the Video Service requires either a monochrome or a 
color direct drive analog monitor with a 31.5 KHz horizontal scan frequency. 


The display’s vertical gain is adjusted automatically by the VGA-compatible 
circuitry. Thus, video modes with 350, 400, and 480 horizontal scan lines 
can be displayed without requiring manual adjustment. 
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Video I/O Ports 


INT 10h, Video Service, references the following |/O ports: 


Read/Write 
1/O Address Status | Description 


W System control port B, where: 
Bit 7 = 1 Reset timer 0 output latch (IRQ 0) 
Bits 6-4 = Reserved 
Bit 3 = Q Enable channel check 
Bit 2 = 0 Enable parity check 
Bit 1 = 1 Speaker data enable 
Bit O = 1 Enable timer 2 gate to speaker 


0064h 8042 Commands 


8042 Status, where: 


0064h 

Bit 7 = 1 Parity error 
Bit 6 = 1 General time out 
Bit5 = 1 Auxiliary output buffer full 
Bit 4 = 1 Inhibit switch 
Bit3 = 1 Command/data 
Bit 2 = System flag 

Bit 1 = 1 Input buffer full 
BitO = 1 Output buffer full 


03B4h 
03B5h 
O03BAh 
O3BAh 
03CO0h 
03COh 
03Cth 
03C2h 


[| _VGa input status register + (mono) 
[RW [VGA atirbute aad regiter 
TR _| other VaA atirbute registers 
a 
— 
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Video I/O Ports, Continued 


Read/Write 
1/O Address Status Description 


Tscon [| mR _| Vea misoolaneous output egiter 
[—oa5eh [Rw |VGA GRIT controler dex register (oon) 
[—oapsn [aw | otter Va CRT controler registers (color) 
[span 


VGA feature control register (color) 
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Video Modes 


Introduction 


The CBIOS Video Service supports 17 video modes, providing backward 
compatibility with MDA, CGA, and EGA modes, as well as compatibility with 
all new VGA modes. 

Models 25 and 30: IBM PS/2 Models 25 and 30 which utilize multicolor 


graphics array (MCGA) video subsystems support six video modes, which 
are outlined in a separate table. 


Table of CBIOS video modes 


The table below lists the 17 video service modes supported by the CBIOS 
Video Service. 


wode| emut| nos | swee | ete |sonome) Sse | Mae] St 

Mode Type Colors Scheme; Box Pgs. 

0,1 | eas | s20x350 | Text | te/2sck | aoxes | axis | 8 | 

eae | sonene | _test___pasek_f ataes fds 8 B8000 
Le 


recas | 640x360 | Text | t6r2sex | ones | axa | 
“can [640x200 | Graphics | 27288 | e028 | we | 1 
7 | moa | 720x360 | Text [MDA Mono | 0x25 | oxi | 6 
[ean | 220x200 [Graphics | ter2sex | aos | oe | 8 
ean [640x200 | Graphics | 16/256 | e028 | oe | a 

EGA 

GA 

GA 

VGA 


C 

ae 

| EGA | 640x350 | Graphics | 16/256 | 80x25 | axi4 | 2 
640x480 | Graphics | _2/256K__| 80x30 | sxt6 | 1 | A000 
| VGA | 640x480 | Graphics |_16/256K_| 80x30 | exis | 1 _| 
__vaa_| 320x200 | Graphics | 2s6/25ek | 40x25 | axé | 1 


Legend: “!” indicates power-on default mode 
! = color monitor is attached, 
7! = monochrome monitor is attached. 
indicates that scan lines must be specified before mode set. (See AH 
12h BL = 30h Select Scan Line for Alphanumeric Codes for details. ) 
“+” indicates default mode | 


66 we? 
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Video Modes, Continued 


Model 25 and 30 video modes 


The table below lists the video modes supported by IBM Models 25 and 30 
with MCGA. 


al ena [mo nw | Se Jn] 3 [| 
Mode Type Colors Scheme| Box Pgs. Start 
0.1 | cant | s2oxsoo| Text | revessx | 4oxzs | axis | 9 | B8000_ 
2, 3 

CGA 

CGA 
7 MDA 

VGA 

VGA 


320x200 | Graphics| 4/256K | 40x25 B8000 
: 


ean [ea0x200 [raphics | 2725eK | 800s | &e | 1 | 60000 
mba [720x350 | Text [MDA Mono | 0x25 | oxra | 6 | 0000 
VGA 


640x480 | Graphics | 2/256K | 80x30 1 | Aoooo 
320x200 | Graphics | 256/256K | 40x25 | 8x8 | 1 | A0000 


Legend: “t” indicates that 320x200 or 640x200 is used if hardware initialization detects 
a nonstandard monitor type. 


eopeacgmar ee 
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Video Modes, Continued 


Video mode facts 


The facts below apply to the Video Service modes listed on the previous 
page. 


| Modes 0, 2, 4 = Modes 1, 3, 5 | In CGA mode, modes hex 1, 3, and 5 have color 
burst turned on and modes hex 0, 2, and 4 have color | 
burst turned off. The VGA hardware does not support 
color burst; modes hex 0, 2, and 4 are identical to 
modes hex 1, 3, and 5 respectively. 


200-line modes double-scanned | All 200 scan line modes are double-scanned by the 
analog monitor. Each line of video is painted on the 
| screen twice, one beneath the other, before the next 
new scan line is painted. 


Number of text mode lines may | 200, 350, or 400 scan lines can be displayed in all text 
modes. The number of scan lines to display is se- 
lected via Video Service function AH = 12h, BL = 30h 
Alternate Select. Refer to AH = 12h in this chapter for | 
further details. 


No cursor in graphics The cursor is not displayed in graphics modes. 


MDA, CGA, EGA Emulation To insure compatibility with older software, the CBIOS 
Video Service supports all 200 and eee scan line MDA, 
CGA, and EGA video modes. 
To activate a 200 or 350 scan line mode: 


* Execute function AH = 12h, BL = 30h Alternate | 
Scan Line Select with AL = 00h or Oth. (i. e. 200 or | 
350 scan lines) 


» Execute function AH = 00h Set Mode 


Note: Unless otherwise indicated, the BIOS defaults 
to 400 scan lines for all text modes. 
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Mode/Monitor Support 


Color/Monochrome analog monitors display all modes 


Both monochrome and color 31.5 KHz direct drive analog and multiscan 
monitors can display all of the modes listed in the table of video modes 
earlier in this chapter. 


The following facts apply: 


Se ee 


| A monochrome analog 


) Colors are displayed as shades of gray, with the maxi- 
monitor is attached... 


mum number of shades equal to the maximum number of 
colors display in the respective mode. In mode OEh, for 
example, 16 shades of gray can be displayed. 


Mode 13h is an exception to this rule. Only 64 (and not 
256) shades of gray can be displayed in mode 13h. 


A color analog monitor is The colors displayed are selected from a BlOS-initialized 

attached... palette of 64 color registers. The number of colors dis- 
played in each mode is listed in the table of video modes 
above. In mode OEh, for example, 16 different colors can 
be displayed. 


The BIOS initializes the 64 colors in this palette to analog 
equivalents of the 64-color digital EGA palette. The re- 
maining 192 color registers are undefined. 


Mode 13h is an exception to this rule. Mode 13h is capa- 
| ble of displaying all of the 256 colors stored in the DAC. 
| The BIOS initializes these colors to IBM-compatible de- 
faults at mode set. 


Models 25 and 30: In MCGA-based systems, the BIOS 
initializes the first 16 color registers, leaving 240 color 
registers undefined. 


A 200 scan line mode is se- | All 200 scan line modes are double-—scanned. That is, 
lected... each horizontal line is scanned twice, for a total of 400 
| scan lines. This is true for both color and monochrome 
analog monitors. 


Power-on default video The default power-on mode is mode 3+ (720x400, 
modes are in effect ... 16-color) when a color analog monitor is attached, or 


The default power-on mode is mode 7+ (720x400, 
monochrome) when a monochrome analog monitor is 
attached. 


Models 25 and 30: In MCGA-based systems, the de- 
fault power-on mode is 3. 
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ROM Character Generators 


ROM-resident fonts 


The ROM BIOS contains three BlOS-resident character generators (fonts): 
es 8x8 dot 


» 8x14 dot (not available in IBM Models 25 and 30 with MCGA) 
» 8x16 dot 


9x14 and 9x16 dot fonts 


The BIOS is also capable of generating a 9x16 dot font in text modes 0+,1+, 
2+, 3+, and 7+. However, the BIOS generates this 9x16 font by running the 
8x16 character set through a ROM-resident table of corrections. The 9x16 
font is not available to BIOS end users through the AH = 11h Character 
Generator function. | 


The 9x14 dot font is created in the same way that the 9x16 dot font is, 
except that it is based on the 8x14 character set. The 9x14 dot font is used 
in mode 7. 


Text mode fonts and memory map 2 


In text modes, the ASCII character number is written to video memory map 
O and the corresponding attribute is written to memory map 1. 


Memory map 2 is used for storing character generator (font) data. Each font 

occupies one 8K block, making for a total of eight possible fonts. A maxi- 
mum of two 256-character fonts (i.e. 512 characters) can be displayed at 
one time. The Video Service Set Block Specifier subfunction provides BIOS 
controls for selecting which two blocks are to be displayed. (See AH = 11h, 
AL = 03h in this chapter for details.) 
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ROM Character Generators, Continued 


Default fonts 


The font associated with a given video mode is directly related to the resolu- 
tion that mode is capable of reproducing. The table below outlines the font/ 
resolution relationship. 


If the resolution Is.... Then the default font Is... 


How fonts are loaded 
Each time a video mode is set, the CBIOS automatically loads the font 
associated with the specified mode into block 0 in memory map 2. 


Note: For 200 and 350 scan line text modes, the user must set the number 
of scan lines through the Video Service subfunction AH = 12h, 
BL = 30h, Select Scan Lines for Text Modes, before mode set. 


Overriding default fonts and default memory blocks 


The Video Service functions AH = 11h Character Generator and AH 12h 
Alternate Select contain subfunctions that enable the user to: 

« Load a default font into a nondefault character block in memory map 2 
= Specify a nondefault font for display in text or graphics modes 

=» Load user-defined font for display in text or graphics modes. 

= Control the number of scan lines in text modes 


Refer to the Character Generator and Alternate Select headings in this chap- 
ter for further details. 
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System RAM Data 


Video data definitions 


The data definitions used by the INT 10h Video services are stored in system | 
RAM in segment 40h and are presented below in offset order. 


| System RAM 
Offset (hex) Size Description 


1 Byte Video mode setting. 
Current page size. 
} 1 Word | Current page address. 

8 Words Cursor position on each page. Two bytes/page. 
First byte (low order) of each pair is column, sec- 
ond is row. 0, 0 is upper left corner of screen. 
starting and ending scan lines. High order byte 
holds starting scan line; low order byte holds ending | 


an 
Z 3 | 1 Word | 
| scan line. 
Pah 
en 
87h 


Cursor type defined as 6845 video chip-compatible 


Current page number. 
1 Word 6845 video chip-compatible |/O port number for | 
current mode. (Port 03D4h or 03B4h) 


1 Byte Current mode select register. 


Number of rows on screen (24/25) | | | 
Character height (bytes/character) 


Video control bits, where: 


Bit 7 = Clear RAM 
Bit 6,5 = Memory on video hardware as follows: 
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00b = 64K 

O1b = 128K 

10b = 192K 

lib = 256K 

= Not used 

= 0 EGA-compatible mode active 
= 1 Wait for display enable 


EGA-compatible adapter 
= 1 Monochrome monitor is attached to 
EGA-compatible adapter 
Bit 0 =0 translate cursor video modes 0-3 
eee) using ECD monitor in 350-line 
mode 
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System RAM Data, Continued 


Video data definitions, cont’d 


| System RAM 
Offset (hex) Description 
8h 


EGA/VGA switch data where: 


Bits 7-4 = Feature connector bits 3-0, respectively 
Bits 3-0 = Option switches 3-0, respectively 


VGA control bits, where: 


Bit 7 = 200 lines 

Bits 6-5 = Reserved 

Bit 4 = 400 lines 

Bit 3 = No palette load 
Bit 2 = Mono Monitor 
Bit 1 = Gray Scaling 
Bit 0 = Reserved 


1 Byte Index to the Display Combination Code table 


A8h 1 Word Pointer to video parameter table and overrides (in 
segment:offset format). 


Video Service Pointer Tables 


The Video Service initializes and maintains two system RAM pointer tables. 
Each table consists of seven double-word segment:offset pointers to video 
parameters and optional auxiliary character generator information. 


The Set Mode function, AH = OOh, refers to the video service pointer tables 
(and to the information pointed to by the tables) on every mode set. 


Default table locations 


There are two video service pointer tables: the primary table and the secon- 
dary table. The locations of each of these tables is initialized by the CBIOS 
during the power-on self test and initialization (POST) procedure. The table 
locations are initialized as follows: 


« This memory location (40:A8h in the BIOS Data Area) points to the first 
pointer table. It is initialized by the CBIOS to a default table in ROM. 


« The fifth entry in the first pointer table points to the location of the second 
pointer table. 


Note: Users who wish to override the CBIOS default locations may supply 
their own values for 40:A8h and entry 5 of Table #1. See next page. 
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System RAM Data, Continued 


Structure of Video Service Pointer Table #1 


The location of the first, or primary, pointer table must be stored in 40:A8h. 
This address is initialized by the CBIOS to a default location. 


The table is structured as follows: 


Table Location Description 


Pointer 1 POINTER TO VIDEO PARAMETER TABLE 
initialized at POST to the ROM BIOS video parameter table. 
This table entry is mandatory. If reinitialized, it must point to 
a valid video parameter table. 
POINTER TO DYNAMIC SAVE AREA 


Optional table entry. Initialized at POST to 00:00h. When non- 


zero, this entry must point to a Dynamic Save Area in system 
182 CBIOS for IBM PS/2 Computers and Compatibles 


RAM. The Dynamic Save Area must be at least 256 bytes 
long. It contains the 16 EGA palette register values as well as 
the overscan register value in bytes 0-16, respectively. 


POINTER TO TEXT MODE AUXILIARY CHARACTER 
GENERATOR 


Optional table entry. Initialized by the BIOS to 00:00h. When 
nonzero, this entry must point to a table structured as below: 


Description 


Toword | Pointer toa font table 


Displayable rows, where: 


OFFh = Maximum calculated value otherwise 
indicated number of rows displayed. 


Byte Consecutive bytes of mode values for font. 
| OFFh = Indicates end of stream 
Note: Using this third pointer can cause unexpected cursor 


operation. See “Function: AH = 01h Set Cursor 
Type,” in this chapter for details. 
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System RAM Data, Continued 


Structure of Video Service Pointer Table #1, cont’d 


Table Location Description 


POINTER TO GRAPHICS MODE CHARACTER 
GENERATOR 


Optional table entry. Initialized to 00:00h. When nonzero, this 
entry must point to a table structured as below: 


Description 


Pointer 4 


Displayable rows 


Bytes per character 
Pointer to font table 


Byte Consecutive bytes of mode values for font. 
OFFh = Indicates end of stream 


Pointer 5 POINTER TO VIDEO SERVICE POINTER TABLE #2 (Secon- 
dary Save Pointer Data Area) 


Initialized by the BIOS to the default Pointer Table #2 location. 
This table entry is mandatory. If reinitialized, it must point to 
a valid Pointer Table #2. 


Pointer 6 Reserved. Set by the BIOS to 00:00h 
Pointer 7 Reserved. Set by the BIOS to 00:00h 
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System RAM Data, Continued 


Structure of Video Service Pointer Table #2 


The location of second, or secondary, pointer table must be stored in | 
Pointer 5 of pointer table #1. Pointer 5 of table #1 is initialized by the BIOS 
to a default location. 


The table is structured as follows: 


Table Location Description 
Pointer 1 TABLE LENGTH 
initialized by the BIOS to default table length. 


Pointer 2 POINTER TO DISPLAY COMBINATION CODE (DCC) 


Initialized by the CBIOS to the ROM BIOS DCC table. This table 
entry is mandatory. If reinitialized, it must point to a valid DCC 
table. The DCC table is structured as below: 


| Size | Description 


‘Number of entries in the DCC table __ 


| | Byte | DCC Table Version Number 


Maximum display type code 
Pays | Reseed Cd 


00,00 Entry 0 No Displays 
00,01 Entry 1 MDPA 
| 00,02 Entry 2 CGA 
| 02,01 Entry 3 MDPA + CGA 
00,04 Entry 4 EGA 
04,01 Entry 5 EGA +MDPA 
00,05 Entry 6 MEGA 
02,05 Entry 7 MEGA +CGA 
00,06 Entry 8 Cc 
| 01,06 Entry 9 PGC + MDPA 
05,06 Entry 10 PGC + MEGA 
00,08 Entry 11 CVGA 
01,08 Entry 12 CVGA + MDPA 
00,07 Entry 13 MVGA 
02,07 Entry 14 MVGA + CGA 
02,06 Entry 15 MVGA + PGC 


Abbreviations 


MDPA = Monochrome Display and Printer Adapter 
| CGA = Color/Graphics Monitor Adapter 

| EGA ~~ = Enhanced Graphics Adapter 

| MEGA EGA with monochrome display 

PGC Professional Graphics Controller 

VGA Video Graphics Array 

MVGA = VGA-based with monochrome display 
CVGA = VGA-based with color display 


G) 
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System RAM Data, Continued 


Structure of Video Service Pointer Table #2, cont'd 


Table Location Description 


Pointer 3 POINTER TO SECOND TEXT MODE AUXILIARY CHARACTER 
GENERATOR 


Optional table entry. Initialized by the BIOS to 00:00h When 
nonzero, this entry must point to a table structured as below: 


Description 
Bytes per character 
Block to load, 0 = Normal operation 
Count to store, 256 = Normal operation 
Word | Character offset, 0 = Normal operation | 


Dword | Pointer to a font table 


| | Byte Displayable rows, where: 
7 OFFh = Maximum calculated value; otherwise 
indicated number of rows displayed. 
Byte | Consecutive bytes of mode values for font. 
: OFFh = Indicates end of stream 
Note: Bit 3 of the Attribute byte is used to switch between 
text mode fonts. It may be necessary to employ the 


user palette profile table to define a palette of colors 
independent of attribute bit 3. 
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~System RAM Data, Continued 


Structure of Video Service Pointer Table #2, cont'd 


186 


Description 


Pointer to User Palette Profile Table 


Optional table entry. Initialized by the BIOS to 00:00h. When 
nonzero, this entry must point to a table structured as below: 


| Size Description | 


Underlining flag, where: 


1 =On 7 
9 = Ignore (Normal operation) 
= Off 


Word 


Word tall palette count (0-17), where: 
= Normal operation 


Word Internal palette index (0-16), where: 
0 = Normal operation 
Pointer to Internal palette 


Word External palette count (0-256), where: 
0 = Normal operation 


Word External palette index (0-255), where: 
0 = Normal operation 


Pointer to external palette 


Consecutive bytes of mode values for 


font, where: 
OFFh = Indicates end of stream 


Table Location 


Pointer 4 
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Function: AH = 00h Set Video Mode 


Description 


The Set Video Mode function sets the video mode registers for operation in 
any supported mode. It selects the active video mode if more than one is 
installed, clears the screen, positions the cursor at 0,0 and resets the color 
palette to default color values. (See “Video Modes” in this chapter for a 
description of each mode.) 


Models 25 and 30: IBM PS/2 Models 25/30 (and compatibles) equipped with 
MCGA graphics do not support the full number of VGA video modes. See 
“Video Modes” for more information. 


Input/Output 
Input: AH = QOh 
AL = Video mode, where: 
OOh-—07h — Valid values 
O8h-OCh — Reserved 
ODh-13h — Valid values 
Output: AL = Video mode, where: 


20h — If mode is greater than 7 
30h — If mode is from O-5 or 7 
3Fh — If mode is mode 6 


Additional information 


=» Resetting the same video mode can be used to clear the screen. 


= To avoid resetting the palette when working with colors, use Video Service 
O6h rather than Service OOh to clear the screen. 


« The cursor is not displayed in graphics modes. 

= Modes OQ, 2, and 5 are identical to modes 1, 3, and 4. 

= The power-on default mode with a color analog monitor attached is 3. 

=» The power-on default mode with a monochrome analog monitor attached 
is 7. 

» During mode set, if bit 7 of AL is set, the video buffer is not cleared. 


= Refer to AH = 12h BL = 30h to select alpha mode scan lines (200, 350, 
or 400). 


= For all modes except mode 13, the first 64 color registers are initialized 
and the values in the remaining 192 color registers are undefined. 
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Function: AH = 01h Set Cursor Type 


Description 


The Set Cursor Type function sets the size of the cursor that will appear in 
text modes. Cursor size and location within the character box is determined 
by the starting and ending scan lines indicated in bits 4:0 of registers CH 
and CL respectively. 


The Set Cursor Type function stores cursor size parameters in the cursor 
type byte at 40:60h. 


Models 25 and 30: In IBM PS/2 Models 25 and 30 (and compatibles) equip— 
ped with MCGA graphics, this function multiplies CH by 2, then it multiplies 
CL by 2 and increases the CL product by 1 before writing cursor vaiues to 
MCGA hardware. 


Input/Output 
Input: AH = Oth 

CH = Top scan line, where: 

Bits 7-6 = OOh (must be OOh, otherwise cursor blinking 
becomes erratic) 

Bit 5 = To shut cursor off 
Bits 4-O = Top scan line 

CL = Bottom scan line, where: 


Bit 7 = Undefined 
Bits 6-5 = Show cursor 
Bits 4-O = Lower scan line 


Output: None 
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Function: AH = 01h Set Cursor Type, Continued 


Additional information 

=» Only one cursor type is available for all video pages. 

» The default text mode cursor occupies the bottom two scan lines of the 
character box associated with the given text mode. 

= Setting register bit 5 of the CH register causes the text mode cursor to 
disappear completely. The cursor can also be eliminated by positioning it 
to a nondisplay address, e.g. (x,y) = (0,25) 

» In graphics mode, bit 5 is set automatically, which prevents the cursor 
from being displayed. To simulate the cursor, use the solid block charac- 
ter DFh, or change background attributes. 

» CGA mode can a display cursor on eight lines, numbered O to 7, top 
to bottom. 

» MDA and EGA modes can display a cursor on 14 lines, numbered 0 to 13, 
top to bottom. 

2 MCGA and VGA modes can display a cursor on 16 lines, the default 
character size of this mode. 


Default cursor settings 


The default cursor settings for each mode type are listed below. Default 
cursor settings are established by function AH = OOh at mode set. 


CH = 6, CL =7 
| MDA, EGA CH = 11, CL = 12 
MCGA, VGA CH = 13, CL= 14 
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Function: AH = 02h Set Cursor Position 


Description 


The Set Cursor Position function sets the cursor position (in terms of row- 
by-—column coordinates) for the display page indicated in BL. It saves the 
position as a two-byte row-by-column table entry in the cursor coordinates 
byte at 40:50h. Row and column coordinates are indicated in registers DH 
and DL respectively. 


The Set Cursor Position function applies to both text and graphics video 
modes. In text modes, if the display page selected in BH is the active dis- 
play page, the screen cursor will move to the coordinates indicated in regis- 
ters DH and DL. In graphics modes, the cursor is invisible, but it is used to 
define a position on the screen. 


Input/Output 
Input: AH = OQ2h 
BH = Display page number (see function AH = 05h) 
DH = Row (0 is top row of screen) 
DL = Column (0 is leftmost column) 


Output: AX = OOh 


Cursor Positioning 


Positioning the cursor to coordinates (0,0) places it in the upper left corner 
of the screen in the 80x25 text mode. Selecting coordinates (79,24) in the 
80x25 text mode will allow placement of the cursor in the lower right Corner 
of the screen. The cursor can also be placed in the lower right corner of the 
screen using coordinates (39,24) in the 40x25 text mode. 


The cursor can be turned off by moving it to an off-screen location or 
changing its coordinates to a position such as (0,25). However, if it is 
moved too far off-screen, the actual position if the cursor may become 
unpredictable. 


Additional information 


=» The display page number must be set to 0 in CGA graphics mode. 


= Multiple display pages in 16-color graphics as well as text modes are 
supported by both EGA and VGA. 
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Function: AH = 03h Read Current Cursor Position 


Description 


The Read Current Cursor Position function reads the cursor position for the 
given video page from the cursor coordinates byte at 40:50h. It reads the 
cursor type from 40:60h and returns the current cursor position in text 
coordinates. This function is useful for determining the exact cursor type 
before it is changed. 


Input: AH = O3h 


BH = Display page number (zero—baseqd) 
Output: AX = OOh 

CH = Starting cursor scan line 

CL = Ending cursor scan line 

DH = Row number 

DL = Column number 


A different cursor is maintained for each display page. Each of these cursors 
can be looked at independently with this function, whatever page is currently 
active. How many display pages are available is defined by the display mode 
selected. 


Function: AH = 04h Read Light Pen Position 


Description 


This function reads the light pen’s status and position. PS/2 systems (includ- 
ing Models 25 and 30) do not support light pen input devices. They are not 
effective on monochrome monitors with long image-retention phosphor, and 
the light pen position is not accurate enough for use with high resolution 
devices. 
Input: AH = 04h 
Output: AH = 00h Light pen is not supported 

AL = OOh 


All registers except AX are altered on return. 
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Function: AH = 05h Select New Video Page 


Description 


The Select New Video Page function sets the active page for the video mode 
selected. Refer to the table under the Video Modes heading for a list of the 
maximum number of pages allowed for each video mode. 


Input/Output 


Input: AH 


O5h 


AL New page number (zero-based) 


Output: None 


Additional information 


192 


All page numbers are zero—based (i.e. page numbers begin at page QO). 
In text modes, page numbers range from 0-7. 


Page O, located at the beginning of display memory, is used by default in 
all video modes. 


Switching between pages does not alter their contents. Also, no matter 
which page is active (currently displayed), text can be written to any video 
page using INT 10h functions 02h, O9h and 10h. 


In the CGA mode, no video paging is possible. 


In EGA and VGA modes, video pages are available up to the limits of 
video RAM in both alphanumeric and graphics modes. 


The current cursor position is maintained by the CBIOS for as many as 
eight video pages. 

An instantaneous screen change can be created by building a screen on 
an undisplayed page, then using this function to display it. 
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Function: AH = 06h Scroll Current Page Up 
Function: AH = 07h Scroll Current Page Down 


Description 


The Scroll Current Page Up/Down functions employ the CH, DH, CL, and DL 
registers to define a screen window and allow the contents of the window to 
be scrolled either up or down by the number of character rows specified in 
register AL. If AL = OOh, the window is blanked instead of scrolled. 


Information appearing on the screen but lying outside the parameters of the 
defined window remains on the screen. Only one window can be defined at 
any given time. 


These two functions operate in both text and graphics modes. 


Input/Output 
Input: AH = O6h Scroll current page up 

07h Scroll current page down 

AL = Scroll distance in character rows 
(0 blanks entire scroll area) 

BH = Attribute to use on blanked lines 

CH = Top row of scroll window 

CL = Left column of scroll window 

DH = Bottom row of scroll window 

DL = Right column of scroll window 


Output: None 


Use the cursor positioning and character writing services to fill the blank line 
with text. 


Initializing a Window 


Setting the subfunction register AL = 0 initializes a window on the display 
screen. Setting the AL register to zero blanks out the region specified by the 
CX and DX general purpose registers and fills them with the attribute in the 
BH register. 
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Function: AH = 08h Read Character/Attribute from Screen 


Description 


The Read Character/Attribute from Screen function reads the character at 
the current cursor location. For text modes, the attribute is also returned. In 
graphics modes, the character matrix at the cursor position is compared to 
the bit patterns in the current graphics character definition table to determine 
the character’s ASCII value. Characters other than standard ASCII characters 
are returned as AL = OOh. 


Input/Output 
Input: AH = O8h 
BH = Display page (refer to “Video Modes” for maximum 
pages per mode) 
Output: AH = Attribute (text modes only) 
AL = Character read 


Additional information 
« To read a character from any valid display page (other than the active 
one), specify the display page number. 
# Information about the screen is in screen memory and need not be stored 
in a program. 


» This function can be used to read the screen for TSR spelling and thesau- 
rus utilities. | 


194 CBIOS for IBM PS/2 Computers and Compatibles 


Function: AH = 09h Write Character/Attribute to Screen 


Description 


The Write Character/Attribute function writes the character to the screen 
starting at the current cursor location for as many times as indicated in the 
CX register. The cursor is not moved even if more than one character is 

written, unless the same character is repeated. 


Note: INT 10h functions AH = 09h and AH = OAh are similar. AH = O9h 
should be used for all graphics modes. 


Input/Output 
Input: AH 
AL 
BH 
BL 
CX 


Output: None 
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OSh 

ASCII character to write 

Display page (refer to “Video Modes” for maximum 
pages per mode) 

Background color (graphics mode 13h only) 
Character attribute (text modes) 

Foreground color (graphics modes) (i.e. color of 
character) 

Repeat count 


continued 
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Function: AH = 09h Write Character/Attribute to Screen, Continued 


Additional information 


In text modes, the number of repeats placed into CX may exceed the 
number of columns remaining in a given row. Characters will wrap around 
from row to row. In graphics modes, the number of repeats placed into 
CX cannot exceed the number of columns remaining in a given row. 
Characters will not wrap around from row to row. 


In graphics mode 13h, the color specified in BH determines the screen 
background color. 


In CGA graphics mode, the bit map used for ASCII characters 80-FFh is 
stored in a table that starts at 0:7Ch. This value is stored in the vector for 
INT 1Fh. By resetting the vector, the bit map table location can be 
changed to point to a different bit map. 


For EGA and VGA graphics modes, use the table whose pointer is stored 
in the vector for INT 43h. For further information refer to the INT 10h, 
function AH = 11h AL = 20 and AL = 21 headings in this chapter. 

Any value of AL will produce a display; this includes all control characters 
(e.g. bell, backspace, CR, LF). These control characters are not inter- 
preted as special characters and do not change the cursor position. 
After a character has been written, the cursor has to be explicitly moved 
to the next position using INT 10h function O2h. 

To write a character without changing the attribute at the current cursor 
position, use INT 10h function OAh. 

When this function is used to write characters in graphics mode, and with 
bit 7 of BL set to 1, the character is XORed with the contents of the 
current display. This feature can be used to write characters and then 
erase them. 
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Function: AH = 0Ah Write Character Only to Screen 


Description 


The Write Character Only to Screen function operates identically to the Write 
Character/Attribute function, except that for text modes the attribute bytes 
corresponding to the characters remain unchanged. Use this function to 
write a character to the screen in text modes. 


Note: Use AH = 09h in graphics modes. 


Input/Output 
Input: AH = OAh 
AL = Character to write (ASCII codes) 
BH = Display page (text modes only) 
CX = Repeat count 


Output: None 


Additional information 


=» Any value of AL will produce a display; this includes all control characters 
(e.g. bell, backspace, CR, LF). These control characters are not inter- 
preted as special characters and do not change the cursor position. 

» After a character has been written, the cursor has to be explicitly moved 
to the next position using INT 10h function O2h. 

» To write a character without changing the attribute at the Current cursor 
position, use INT 10h function OAh. 

=» When this function is used to write characters in graphics mode, and with 
bit 7 of BL set to 1, the character is XORed with the contents of the 
current display. This feature can be used to write characters and then 
erase them. 
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Function: AH = OBh Set Color Palette 


Description 


This function selects colors for medium resolution graphics modes. Depend- 
ing on the value placed in BH, the Set Color Palette function will perform any 
of four operations. 
lf BH = OOh, then the value in BL sets the: 
» Background color for 320x200 graphics modes (modes 4, 5) 
» Border color for 320x200 text modes (modes O, 1, 2, 3) 
» Foreground color for 640x200 graphics mode (mode 6) 


If BH = Oth, then the value in BL sets the palette for 320x200 graphics 
modes (modes 4, 5). 


Input/Output 


Input: AH = OBh 
BH = OOh 
= if mode = 4, 5, set background color to value in BL 
= If mode = 0, 1, 2, 3, set border color to value in BL 
= if mode = 6, set foreground color (640x200 graphics) 
to value in BL 
BL = (0-31), when colors (16-31 are high intensity 
background set) 


or 
BH = Oth select palette for modes 4, 5 (320x200 graphics) 
BL = OQOh; Palette = Green (1), Red (2), Brown (3) 


= Oth; Palette = Cyan (1), Magenta (2), White (3) 
Output: None 


Additional information 
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= In CGA graphics modes, bit 4 of BL selects between normal and high 
intensity. EGA and VGA graphics modes emulate this by selecting a 
palette of high intensity colors when bit 4 of BL is set. 


» A flashing display can be set by rapidly changing the palette. 


#» The background color of text is determined by the high order four bits of 
the attribute byte of each character. 
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Function: AH = 0Ch Write Pixel 


Description 


The Write Pixel function writes to video memory the pixel specified by row 
and column number in DX and CX. When a given video mode allows more 
than one page, the (O-based) page number must be indicated in BH. 


For all graphics modes except mode 13h, bit 7 of AL acts as an inverter 
flag. If bit 7 of AH is set, then the color value in AL is exclusively ORed 
(XOR) with the current pixel. That pixel can be erased by writing it a sec- 
ond time. 


Refer to “Video Modes” for a table listing video modes, resolutions, and 
maximum pages/mode. 


Input/Output 
Input: AH = OCh 
AL = Color (Bit 7 is exclusive OR flag) 
BH = Page number (Modes allowing more than one page) 
DX = Pixel row number 
CX = Pixel column number 


Output: None 


Pixel values 


= In four-color graphics modes (display modes 04h and O5h), pixel values 
range from 0-3. 


» In two-color graphics modes (display mode O6h), pixel values range from 
O-1. 
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Function: AH = 0Dh Read Pixel 


Description 


The Read Pixel function returns the value of an addressed pixel to the low 
order bits of the AL register. This function can be used for collision detection 
in video games. It can also be used by advanced graphics programs to 
detect boundaries when moving a graphics object on the screen. 


Refer to “Video Modes” for a table listing video modes, resolutions, and 
maximum pages/mode. 


Input/Output 
input: AH = QDh 
BH = Page number (modes allowing more than one page) 
CX = Column number 
DX = Row number 
Output: AL = Color value of pixel read 


Pixel values 


Display modes 04h, 05h and O6h have valid pixel values in the ranges of 
0-3, 0-3 and 0-1 respectively. Refer to “Video Modes” for a table listing 
video modes, resolutions, and maximum pages/mode. 
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Function: AH = OEh Write Teletype to Active Page 


Description 


The Write Teletype function makes the display appear as a Serial terminal. 
Display characters are written to regeneration memory to the active page 
and the cursor is moved to the next character location (scrolling is neces- 
sary). Screen width is a function of the video mode currently in effect. 


Input/Output 


Input: AH = OEh 
AL Character to write 
BL Foreground color (graphics modes only) 


Output: None 


Special characters 


The four ASCII characters listed below are not displayed but are interpreted 
instead as control characters. All other characters (including other control 
characters) are interpreted as display characters. 


A beep Is sounded. 


Backspace lf the cursor is already on column 0, nothing hap- 
pens. Otherwise, the cursor moves back one 


column. 
Additional information 


last row of the screen, the display is scrolled one 
row. 


The cursor moves to column 0 on the current row. 


= The cursor moves down one row. If done on the 


s When working in the active page, this function allows a character to be 
printed at the current cursor position. After printing the character, the 
function then moves the cursor to the right one space. If by chance the 
cursor is moved past the end of the line, the function will wrap the cursor 
to the next line. Scrolling the screen up one line requires that the cursor 

be moved past the lower right corner of the screen. 


continued 
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Function: AH = OEh Write Teletype to Active Page, Continued 


Additional information, cont’d 


» In CGA text mode, characters can be written to any legal display page, no 
matter which page is active. 


= Compare this function with INT 10h, function 13h. 
» This is the best function for simple output. 


DOS uses 
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DOS uses this function in the console driver for putting operating system text 
and messages on the screen. 


This function does not, however, allow the attribute of a text character to be 
selected. A way of defining an attribute for a character written to the screen 
may be defined by | 


1. writing in the ASCII blank character (20h) having the desired erupele to 
the current position using function 09h, and 


2. writing the desired character using function OEh. 
With this method, the user does not have to provide for line wrapping and 


screen scrolling but can turn these over to the BIOS. 
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Function: AH = OFh Return Video Status 


Description 


The Return Video Status function returns current display mode information. It 
gives the mode, screen width in characters, and the display page number. 


Refer to “Video Modes” in this chapter for maximum pages per mode. 


Input/Output 
Input: AH = OFh 
Output: AH = Number of columns on screen from the screen width byte 
(40:4Ah) 
AL = Current mode from the video mode setting byte (40:49h) 
BH = Active display page number from the display page byte 
(40:62h) 


Examples of function’s use 
Some ways to use this function are 


= for finding out the screen width in the current screen mode before clear- 
ing the screen. 


= to determine the settings of the display system at program initialization so 
that they can be returned to when the program terminates. 
» when writing TSR utilities that pop up on the screen while another applica- 


tion is running. The background application may be running in a different 
mode than the TSR. 
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Function: AH = 10h Set Palette/Color Registers 


Description 


The Set Palette/Color Register consists of 14 subfunctions that control opera- 
tions on the color palette registers within EGA/VGA video controllers. These 
subfunctions allow control of color, blinking and video DAC. 

The 14 subfunctions can be divided into two groups: 


» Subfunctions that service the Attribute Controller’s Internal Palette 
» Subfunctions that service the DAC Color Registers. 


Subfunctions 


AL Value Subfunction Name 


| Oth* Set overscan register | Atrib. Contr. 


Read individual palette register Atrib. Contrl. 
Read overscan register Atrib. Contr. 


Programs 


Read all palette registers and overscan register Atrib. Contr. 
Set individual color register 


Reserved 


wee il Set block of color registers 
Select color paging mode (not valid for mode 13h) DAC 
BL = 00h Select paging mode 
BL = 01h Select page 


DAC 
DAC 
DAC 


Reserved 


Read single DAC color register 
Reserved 


Read block of color registers | 


Reserved 


DAC 
DAC 
DAC 
DAC 
DAC 
DAC 
DAC 


Read color paging status 
Sum color values to gray shades 
* Not supported on IBM PS/2 Models 25 and 30 (and compatibles) with MCGA hardware. 
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Function: AH = 10h Set Palette/Color Registers, Continued 


Reference 


For more information on the relationship between the DAC and the Attribute 
Controller, refer to the Hardware Environment heading in this chapter. 


Error Handling 


The CBIOS Video Service checks for valid parameters upon entry into each 
subfunction. If invalid parameters are detected the subfunction returns with 
all registers preserved. 


Subfunction: AL = 00h Set single palette 


This subfunction sets a single color value in the Attribute Controller’s 
16-value internal palette. Each palette register value points to one location 
among the 256 DAC color registers. This subfunction exits without processing 
if the current mode is 13h. 


Models 25 and 30: In IBM PS/2 Models 25 and 30 (and compatibles) 
equipped with MCGA graphics, input BX = 0712h. This will define a color 
register set that results in eight consistent colors. 


Input: AH = 10h 


AL = OOh set single palette 
BL = Palette register 
BH = New color value 


Output: None 


Subfunction: AL = 01h Set overscan register 


This subfunction sets the overscan color (screen border) for the current 
video modes. 


Input: AH = 10h 
AL = Oth 
BH = Color value to set 


Output: None 
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Function: AH = 10h Set Palette/Color Registers, Continued 


Subfunction: AL = 02h Set all palette registers and overscan (border color) 


This subfunction sets all 16 Attribute Controller internal palette registers, as 
well as the overscan register (11h), to the values pointed to by the 1/-byte 
table by ES:BX. It exits without processing if the current mode is 13h. 


Models 25 and 30: In IBM PS/2 Models 25 and 30 (and compatibles) with 
MCGA graphics, this subfunction is not supported. 


Input: AH = 10h 
AL = 02h 
ES:DX = Pointer to 17-byte table, where: 
Byte 16 = Overscan value (border color) 


Bytes 15-0 = Palette values 
Output: None 


Subfunction: AL = 03h Toggle intensity/blink bit 


This subfunction sets either the background intensity or the foreground 
blinking for CGA, EGA, and VGA modes. 
Input: AH = 10h 
AL O3h 
BL OOh Enable background intensity 
Oth Enable foreground blinking 


Output: None 


Subfunctions: AL = 04h to 06h 
These subfunctions are reserved. 
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Function: AH = 10h Set Palette/Color Registers, Continued 


Subfunction: AL = 07h Read individual palette register 


This subfunction reads the color value of the register input into BL and 
returns that value in BH. 


Models 25 and 30: In IBM PS/2 Models 25 and 30 (and compatibles) with 
MCGA graphics, this subfunction is not supported. 


Input: AH = 10h 

AL = O7h 

BL = Palette register to be read (Range 0-15) 
Output: BH = Value read 


Subfunction: AH = 08h Read overscan register (border color) 


This subfunction reads the color value stored in the overscan register of the 
current color palette. This value defines the current border color. 


Input: AH = 10h 
AL = O8h 
Output: BH = Value read 


Subfunction: AH = 09h Read all palette registers and overscan register 
(border color) 


This subfunction reads the contents of the current palette register and the 
overscan register and outputs the contents to a table pointed to by ES:DX. 
The table pointed to by ES:DX must be 17 bytes long. 


input: AH = 10h 
AL = O9h 
ES:DX: Pointer to 17-byte buffer for return values 


Output: ES:DX = Pointer to 17-byte table destination, where: 
Byte 16 = Overscan value (border color) 
Bytes 15-0 = Register color values 
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Function: AH = 10h Set Palette/Color Registers, Continued 


Subfunction: AL = 10h Set individual color register 


This subfunction reads in a table of RGB color values from the area pointed 
to by ES:DX. The number of the first DAC color register to set is specified in 
BX. The total number of color registers to set is specified in CX. Each red, 
green, and blue entry must be one byte long. 


Bits 7-6 are “don’t care” bits. Bits 5-O are set as 3Fh (most intense) to 


OOh (off). 


Input: AH 
AL 
BX 
DH 


CH 


CL 


Output: None 


10h 

10h 

Color register to set 

Red value to set, where: 

Bits 7-6 = Reserved 

Bits 5-0 = 3Fh Most intense; 00h = Off (black) 
Green value to set, where: 

Bits 7-6 = Reserved 

Bits 5-O = 3Fh Most intense; OOh = Off (black) 
Blue value to set, where: 

Bits 7-6 = Reserved 

Bits 5-0 = 3Fh Most intense; OOh = Off (black) 


With gray scale summing selected, the weighted sum gray shade value 
is calculated and saved to each of the three RGB parts of the color regis— 
ter. See INT 10h, function 10h, subfunction 1Bh for a description of this 


calculation. 


Subfunction: AL = 11h 


This subfunction is reserved. 
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Function: AH = 10h Set Palette/Color Registers, Continued 


Subfunction: AL = 12h Set block of color registers 


This subfunction sets a consecutive series of DAC color registers. Input the 
number of the first color register to set in BX, the number of color registers 
to set in CX, and the pointer to the table of color values in ES:DX. 


Input: AH = 10h 
AL = 12h 
BX = First color register to set 


CX Number of color registers to set 
ES:DX = Pointer to table of color values. Table format is red, 
green, blue, red, green, blue 


Output: None 


With gray scale summing selected, the weighted sum gray shade value 

is calculated and saved to each of the three RGB parts of the color regis- 
ter. See INT 10h, function 10h, subfunction 1Bh for a description of this 
calculation. 
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Function: AH = 10h Set Palette/Color Registers, Continued 


Subfunction: AL = 13h Select color paging mode 


The DAC chip contains 256 color registers. In all modes except mode 13h 

(i.e., 256-color graphics), the DAC color registers can be logically divided 

into four blocks, each containing 64 color registers, or into 16 blocks, each 
containing 16 color registers. 


Depending on the value placed into BL, this subfunction performs two 
operations: 


» When BL = OOh, the value placed in BH selects whether the 256 DAC 
color registers will be logically divided into four blocks of 64 color regis- 
ters or into 16 blocks of 16 color registers. 

» When BL = Oth, the value placed in BL selects an individual block of color 
registers. When in four—block mode, the allowable range for BH is 
OOh-03h. When in 16-block mode, the allowable range for BH is OOh—OFh. 


Models 25 and 30: In IBM PS/2 Models 25 and 30 (and compatibles) with. 
MCGA graphics, this subfunction is not supported. 


Input: AH = 10h 


AL = 13h 

BL = OOh Set block mode 

BH = QOh Set 4 blocks of 64 registers 
= Qtih Set 16 blocks of 16 registers 

or | 

BL = Oth Select individual block 


BH = QOh-O3h for 4-block mode 
OOh-OFh for 16-block mode 


Output: None 


The Set Mode functions (AH = 10h, AL = OOh) defaults to the 64 register/ 
block mode, initializing only the first block of 64 color registers. Alternate 
blocks of color registers are initialized through the select paging mode 
subfunction (AH = 10h, AL = 13h, BL = OOh). Alternate blocks of color 
registers must be initialized for the “select page” subfunction (AH = 10h, 
AL = 13h, BL = Oth) to operate properly. 
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Function: AH = 10h Set Palette/Color Registers, Continued 


Subfunction: AL = 14h 
This subfunction is reserved. 


Subfunction: AL = 15h Read single DAC color register 
This subfunction reads an individual DAC color register. 


Input: AH = 10h 

AL = 15H 

BX = Color register to read 
Output: CH = Green value 

CL = Blue value 

DH = Red value 


Subfunction: AL = 16h 
This subfunction is reserved. 


Subfunction: AL = 17h Read block of color registers 


This subfunction reads a block of DAC color registers to the buffer area 
pointed to by ES:DX. 


Input: AH = 10h 
AL = 17h 
BX = Which DAC color register begins block 
CX = Total number of color registers to read 


ES:DX = Pointer to buffer to save register information in. 
(3 bytes per color register). Format as red byte, green 
byte, blue byte...) 


Output: ES:DX = Pointer to values read 


Subfunctions: AL = 18h to 19h 


These subfunctions are reserved. 
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Function: AH = 10h Set Palette/Color Registers, Continued 


Subfunction: AL = 1Ah Read color paging status 


This subfunction returns the current color paging mode as well as the current 
color page within this mode. See INT 10h, function 10h, subfunction 13h, 
Select color paging mode. 


Models 25 and 30: In IBM PS/2 Models 25 and 30 (and compatibles) with 
MCGA graphics, this subfunction is not supported. 


Input: AH 
AL 
Output: BH 
BL 


10h 
1Ah 


Current page 

Current paging mode 

OOh (4 pages of 64 registers) 
Oih (16 pages of 16 registers) 


Subfunction: AL = 1Bh Sum color values to gray shades 


This subfunction reads the red, green, and blue values stored in the speci- 
fied color registers and performs the following weighted sum: 


Gray Shade = 30% red + 59% green + 11% blue 


The resulting red, green, and blue values are written to the specified color 
registers. The original contents of each register are not retained. 


Input: AH 
AL 
BX 
CX 
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10h 

1Bh 

Color register to start with 
Count of how many to sum 
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Function: AH = 11h Character Generator 


Description 


The Character Generator function consists of 14 subfunctions, all of which, in 
one way or another, permit the loading and/or enabling of text mode and 
graphics mode character generators (fonts). 


For more information on text and graphics modes character generators, turn 
to the ROM Character Generators heading near the beginning of this chapter. 


Character generator subfunctions 


The Character Generator subfunctions are invoked by passing the proper 
parameter in the AL register. The subfunctions are listed in the table below: 


AL Value Subfunction Name 


| Loadusertextmode font user text mode font 


a Load ROM 8x14 text mode font 
Load ROM 8x8 text mode font | 
03h Set block specifier (text modes only) 


oa 
2 
zr 


* Not supported on IBM PS/2 Models 25 and 30 (and compatibles) with MCGA hardware: 


i 
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Function: AH = 11h Character Generator, Continued 


Subfunction: AL = 00h Load user text mode font 


214 


This subfunction loadsa user-defined font into the memory map 2 block 
specified in BL. The user font must be stored in a table pointed to by ES:BP, 
with the ASCII character ID or the first character specified in DX.This function 
is for fonts in text display mode. For fonts in graphics mode, see INT 10h, 
function 11h, subfunctions 20h-24h. 


Input: AH 
AL 
BH 
BL 
CX 
DX 


ES:BP = 


Output: None 


11h 


= QOh 


Number of bytes per character 


= Block to load (valid values are 0-7) 


Number of characters to store 
Character ID of first character in ES:BP table 
Pointer to the user table 


Scan lines per character, number of character rows, buffer length, and 
cursor size are not recalculated by this subfunction. The user-defined font 
loaded here must occupy the same character box size as the mode the font 
will be displayed under. 
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Function: AH = 11h Character Generator, Continued 


Subfunction: AL = 01h Load ROM 8x14 text mode font 


This subfunction loads the ROM-resident 8x14 font into the memory map 2 
block indicated in BL. Use this subfunction to override the CBIOS default 
character block location for 8x14 character video modes. For fonts in graph- 
ics mode, see INT 10h, function 11h, subfunctions 20h-24h. 


Models 25 and 30: This function is not available on IBM PS/2 Models 25 and 
30 with MCGA. If called, AL = 04h is executed. 


Input: AH = 11th 
AL = Oth 
BL = Block to load (valid values are Q-7) 


Output: None 


Subfunction: AL = 02h Load 8x8 double dot text mode font 


This subfunction loads the ROM-resident 8x8 font into the character block 
indicated in BL. Use this subfunction to override the CBIOS default character 
block location for 8x8 character video modes. For fonts in graphics mode, 
see INT 10h, function 11h, subfunctions 20n-24h. 


Input: AH = 1th 
AL 02h 
BL Block to load (valid values are 0-7) 


Output: None 
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Function: AH = 11h Character Generator, Continued 


Subfunction: AL = 03h Set block specifier (text modes only) 


VGA-compatible hardware allows the user to display up to 512 text mode 
characters at a time. However, in text modes, all character font bit patterns 
are stored in 8K blocks in video memory map 2. Each 8K block can store up 
to 256 characters. In order to display 512 text mode characters, then, 
special steps need to be taken to allow end user software to select between 
either of two possible 8K character blocks. 


This subfunction sets up the video hardware so that bit 3 of each text mode 
attribute byte can select between either of two memory map 2 character 
blocks, thus allowing up to 512 characters to be displayed in any text mode. 
Characters are selected according to the rules below: 


=» The value of bits 4, 1, 0 of BL set by this subfunction indicates the first 
character block; the value of bits 5, 3, and 2 in BL indicates the second 
character block. 


=» The value of bit 3 of each character attribute byte determines from which 
character block a given ASCII character will be selected. 
= When bit 3 = 0, the character is selected from the block defined by bits 
4, 1, and 0 that input into BL. 
» When bit 3 = 1, the character is selected from the block defined by bits 
5, 3, and 2 of BL. 


= If bits 4, 1, O = bits 5, 3, 2, then bit 3 of the character attribute byte 
toggles foreground intensity on or off. When two character blocks are 
selected, function call AX = 1000h BX = 0712h will ensure that eight 
consistent color planes are set. 


Note: To make a loaded character block active, this subfunction must be 
run after any load character block subfunction. 


Input: AH = 1th 
AL = O3h 
BL = Select character block (see description above) 


Output: None 
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Function: AH = 11h Character Generator, Continued 


Subfunction: AL = 03h Set block specifier (text modes only), cont’d 


Models 25 and 30 — On IBM PS/2 Models 25 and 30 (and compatibles) 
equipped with MCGA hardware, the following rules apply: 


» The values of Bits 1 and 0 in BL indicate the first character block; the 
values of bits 3 and 2 indicate the second character block. 

= The value of bit 3 of each character attribute byte determines from which 
character block a given ASCII character will be selected. When bit 3 = 0, 
the character is selected from the block defined by BL bits 1 and 0. When 
bit 3 = 1, the character is selected from the block defined by BL bits 3 
and 2. 

= If BL bits 1 and O = bits 3 and 2, then bit 3 of the attribute byte turns 
foreground intensity on and off. 


Subfunction: AL = 04h Load 8x16 ROM text mode font 


This subfunction loads the ROM-resident 8x16 font into the character block 
indicated in BL. Use this subfunction to override the CBIOS default character 
biock for 8x16 character block modes. For fonts in graphics mode, see INT 
10h, function 11h, subfunctions 20h-24h. 


Input: AH = 11th 
BL = Block to load (valid values are 0-7) 
Output: None -. 
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Function: AH = 11h Character Generator, Continued 


Description: Subfunctions: AL = 10h, 11h, 12h, 14h 


Subfunctions AL 
subfunctions AL 


10h, 11h, 12h, and 14h, respectively, are identical to 
OOh, O1h, 02h, and 04h except for the following: 


Page 0 is active 

Bytes per character (points) are recalculated 
Number of rows is recalculated 

Display buffer length is calculated 

CRTC registers below are reprogrammed: 

» Index O9h Maximum scan line index 

» OAh Cursor start index 

» OBh Cursor end index 

» 12h Vertical displacement end index 

=» 14h Underline location (mode 07h only) 


Models 25 and 30: These subfunctions are not available on IBM PS/2 Models 
25 and 30 (and compatibles) with MCGA hardware. If called, AL = 10h 
executes AL = OOh; AL = 11h executes AL = Oth; AL = 12h executes AL = 
O2h, and AL = 14h executes AL = 04h. . 


Notes: 
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The registers programmed by subfunctions 10h, 11h, 12h, and 14h are a 
subset of all VGA CRTC registers. Because of this, the font downloaded 
by each of these subfunctions must be relatively close in size to the 
default font associated with the current video mode. To prevent unpredict- 
able results, these subfunctions should only be called after a mode set 
call (i.e., INT 10h AH = 00h Set Mode). 

These functions are for fonts in text display mode. For fonts in graphics 
mode, see INT 10h, function 11h, subfunctions 20h-24h. 
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Function: AH = 11h Character Generator, Continued 


Subfunction: AL = 10h Load user text mode font (after mode set) 


This subfunction loads the user character set defined in the table pointed to 
by ES:BP to the character block indicated BL. 


Models 25 and 30: This subfunction is not supported on IBM PS/2 Models 
25 and 30 (and compatibles) with MCGA hardware. If called, subfunction 
AL = 10h executes AL = OOh. 


Input: AH 
AL 
BH 
BL 
CX 
DX 


ES:BP = 


Output: None 


11h 

10h 

Number of bytes per character 

Block to load (valid values are 0-7) 

Number of characters to store 

Character ID of first character in ES:BP table 
Pointer to table 


The registers programmed by subfunction 10h are a subset of all VGA CRTC 
registers. Because of this, the font downloaded by this subfunction must be 
relatively close in size to the default font associated with the current video 
mode. To prevent unpredictable results, these subfunctions should only be 
called after a mode set call (i.e., INT 10h AH = Set Mode). 
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Function: AH = 11h Character Generator, Continued 


Subfunction: AL = 11h Load ROM 8x14 text mode font (after mode set) 
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This subfunction loads the ROM 8x14 font into the character block indicated 
in BL. Bytes/characters (point size), number of display rows, cursor and 
underline parameter, and display buffer length are recalculated. Use this 
subfunction to override the CBlOS—defined font for the text mode in question. 


Models 25 and 30: This subfunction is not supported on IBM PS/2 Models 
25 and 30 (and compatibles) with MCGA hardware. If called, subfunction 
AL = 11h executes AL = O1h. 


Input: AH = 11h 
AL = 1th 
BL = Block to load (valid values are 0-7) 


Output: None 


The registers programmed by subfunction 11h are a subset of all VGA CRTC 
registers. Because of this, the font downloaded by this subfunction must be 
relatively close in size to the default font associated with the current video 
mode. To prevent unpredictable results, these subfunctions should only be 
called after a mode set call (i.e., INT 10h AH = Set Mode). 
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Function: AH = 11h Character Generator, Continued 


Subfunction: AL = 12h Load ROM &x8 double dot text mode font 


This subfunction loads the ROM 8x8 font into the character block indicated in 
BL. Bytes/character (point size), number of display rows, Cursor and under- 

line parameters, and display buffer length are recalculated. Use this subfunc- 
tion to override the BlOS-—defined font for the text mode in question. 


Models 25 and 30: This subfunction is not supported on IBM PS/2 Models 25 
and 30 (and compatibles) with MCGA hardware. If called, subfunction AL = 
12h executes AL = QO2h. 


Input: AH = 1th 
AL = 12h 
BL = Block to load 


Output: None 


The registers programmed by subfunction 12h are a subset of all VGA CRTC 
registers. Because of this, the font downloaded by this subfunction must be 
relatively close in size to the default font associated with the current video 
mode. To prevent unpredictable results, these subfunctions should only be 
called after a mode set call (i.e., INT 10h AH = Set Mode). 
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Function: AH = 11h Character Generator, Continued 


Subfunction: AL = 14h load ROM 8x16 text mode font 
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This subfunction loads the ROM 8x16 font into the character block indicated 
in BL. Bytes/character (point size), number of display rows, cursor and 
underline parameters, and display buffer length are recalculated. Use this 
subfunction to override the BlOS—defined font for the text mode in question. 


Models 25 and 30: This subfunction is not supported on IBM PS/2 Models 
25 and 30 and compatibles with MCGA hardware. If called, subfunction 
AL = 14h executes AL = 04h. 


Input: AH = 1th 
AL = 14h 
BL = Block to load 


Output: None 


The registers programmed by subfunction 14h are a subset of all VGA CRTC 
registers. Because of this, the font downloaded by this subfunction must be 
relatively close in size to the default font associated with the current video 
mode. To prevent unpredictable results, these subfunctions should only be 
called after a mode set call (i.e., INT 10h AH = Set Mode). 
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Function: AH = 11h Character Generator, Continued 


Description: Subfunctions: AL = 20h, 21h, 22h, 23h, 24h 


Subfunctions AL = 20h, 21h, 22h, 23h, and 24h all deal with fonts that are 
used in graphics modes. For functions that deal with fonts in text display 
mode, see INT 10h, function 11h, subfunctions OOh-14h. 


To prevent unpredictable results, subfunctions AL = 20h, 21h, 22h, 23h, and 
24h should be called only immediately after a mode set 
(INT 10h, AH = OOh, AL = mode to select). 


Subfunction: AL = 20h Set user graphics font pointer at INT 1Fh (8x8 font) 


This subfunction sets the graphics font pointer to the vector contained in INT 
1Fh. The INT 1Fh vector is specified in ES:BP. The font table pointed to is 
used by applications programs running in graphics modes 04h-O6h (CGA 
only) for character codes 80h-FFh. 


Input: AH = 11h 
AL = 20h 
ES:BP = User graphics font pointer 


(INT 1Fh is set to the vector contained in ES:BP) 
Output: None 


Notes: 


= The character generators for all graphics modes are contained within the 
CBIOS. The ROM BlOS-based character generators for graphics modes 
ODh to 13h contain all 256 ASCII characters. 


» The character generators for graphics modes 04h, 05h, and O6h, (CGA- 
compatible graphics modes), contain only the first 128 ASCII characters. 
The remaining 128 ASCII characters (extended ASCII characters 80h-FFh) 
may be supplied by the user. All user-supplied character sets must be 
vectored at a memory location pointed to by INT 1Fh. In general, these 
user—supplied character sets are built into an 8x8 character box. 

» The DOS command GRAFTABL loads a graphic table which allows modes 
04h, 05h, and O6h to display extended ASCII characters. Vectoring INT 
1Fh to point at the DOS GRAFTABL graphics table is the usual method of 
providing user-supplied extended ASCII characters. For more information, 
refer to the MS-DOS technical reference manual. 
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Function: AH = 11h Character Generator, Continued 


Subfunction: AL = 21h Set user graphics font pointer at INT 43h 
(EGA/VGA only) 


This subfunction sets the graphics font pointer to the vector contained in INT 
43h. To avoid unpredictable results, this function should be called only after 
a mode set (INT 10h, AH = 00h Set Video Mode). The INT 43h vector is 
specified in ES:BP. | | 


Input: AH = 11h 
AL = 21h 
BL = Rows on screen specifier 


= QOh if user—supplied 
Oih = 14 (OEh) rows 
O2h = 25 (19h) rows 
| 03h = 43 (2Bh) rows 
CX = Points (bytes/character) 
DL == Rows per screen (if BL = OOh) 
ES:BP = Pointer to user table 


Output: None 
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Function: AH = 11h Character Generator, Continued 


Subfunction: AL = 22h Use ROM 8x14 font for graphics 


This subfunction specifies the use of the ROM-based 8x14 font in EGA and 
VGA graphics modes. Use it to display the 8x14 font in non-—8x14 font graph- 
ics modes. To avoid unpredictable results, this function should be called only 
after a mode set (INT 10h, AH = 00h Set Video Mode). This Subfunction 
should be used in conjunction with subfunction AH = 11h, AL = 21h, Set User 
Graphics Font Pointer at INT 43h. 


Models 25 and 30: This subfunction is not supported on IBM PS/2 Models 25 
and 30 (and compatibles) with MCGA hardware. If called, AL = 22h executes 
subfunction AL = 24h. 


Input: AH = 1th 
AL = 22h 
BL = Row specifier 


= QOh if user-supplied 
O1th = 14 (OEh) rows 
O2h = 25 (19h) rows 
O3h = 43 (2Bh) rows 
DL = Rows per screen (if BL = OOh): 


Output: None 
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Function: AH = 11h Character Generator, Continued 


Subfunction: AL = 23h Use ROM 8x8 double dot font for graphics 


This subfunction specifies the use of the ROM-based 8x8 font in EGA and 
VGA graphics modes. Use it to display the 8x8 font in non—8x8 font graphics 
modes. To avoid unpredictable results, this function should be called only 
after a mode set (INT 10h, AH = 00h Set Video Mode). This subfunction 
should be used in conjunction with subfunction AH = 11h, AL = 21h, Set User 
Graphics Font Pointer at INT 43h. 
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Input: AH = 
AL = 
BL = 


DL = 
Output: None 


11h 

23h 

Row specifier 

OOh if user—supplied 

Oth = 14 (OEh) rows 

O2h = 25 (19h) rows 

O3h = 43 (2Bh) rows 

Rows per screen (if BL = OOh) 
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Function: AH = 11h Character Generator, Continued 


Subfunction: AL = 24h Use ROM 8x16 font for graphics 


This subfunction specifies the use of the ROM-—based 8x16 font in EGA and 

VGA graphics modes. Use it to override to display the 8x16 font in non-8x16 
font graphics modes. To avoid unpredictable results, this function should be 
called only after a mode set (INT 10h, AH = OOh Set Video Mode). This sub- 
function should be used in conjunction with subfunction AH = 11h, AL = 21h, 


Set User Graphics Font Pointer at INT 43h. 


Input: AH 
AL 
BL 


DL 
Output: None 
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11h 

24h 

Row specifier 

OOh if user—supplied 
Oth = 14 (OEh) rows 
O2h = 25 (19h) rows 
O3h = 43 (2Bh) rows 


Rows per screen (if BL = OOh) 
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Function: AH = 11h Character Generator, Continued 


Subfunction: AL = 30h Get font pointer information 


This subfunction returns font pointer information. The pointer information 
desired is requested in the BH register. To avoid unpredictable results, this 
subfunction should be issued immediately after a mode set. 


Models 25 and 30: IBM PS/2 Models 25 and 30 and compatibles equipped 
with MCGA hardware do not support 9x14 or 9x16 dot fonts. Calling this 
function with BH = 05h or 07h yields undefined results. 


Input: AH = 
AL = 
BH = 


Output: CX = 
DL = 


ES:BP = 


11h 
30h 


Font pointer, where: 
= 00h Return 


Oih Return 
02h Return 
O3h Return 
04h Return 
O5h Return 
O6h Return 
O7h Return 


current INT 1Fh pointer 

current INT 43h pointer 

ROM font 8x14 pointer 

current ROM 8x8 font pointer 
current ROM 8x8 font pointer (top) 
current ROM 9x14 font alternate 
current ROM 8x16 font pointer 
current ROM 9x16 font alternate 


>07h Returns all registers (including AX) preserved 


Bytes per character 
Maximum number of rows on screen 


Pointer to character table 
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Function: AH = 12h Alternate Select 


Description 


The Alternate Select function contains several subfunctions. Each subfunction 
allows the user to enable or disable certain operations which are standard 
video mode defaults. For example, the Video Service automatically programs 
the DAC color registers each time the video mode is set. Alternate Select 
subfunction AL = 31h allows the user to selectively enable or disable DAC 
programming on mode set. 


Alternate select subfunctions 
The alternate select subfunctions are listed in the table below: 


BL Value Subfunction Name 


Return VGA information 
Switch to alternate print screen routine 
Select scan lines for text modes 


Enable/disabie defauit palette loading during mode set 


a Enable/disable video 


* Not supported on IBM PS/2 Models 25 and 30 (and compatibles) with MCGA hardware. 


Error handling 


The Video Service checks for valid parameters upon entry into each alter- 
nate select subfunction. If an invalid parameter is detected, the subfunction 
returns with all registers preserved. 
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Function: AH = 12h Alternate Select, Continued 


Subfunction: BL = 10h Return VGA information 
This subfunction returns the state of VGA hardware. 


Models 25 and 30: This function is not available on IBM PS/2 Models 25 
and 30 and compatibles with MCGA hardware. 


Input: BL 
Output: BH 
BL 
CH 
CL 


— 
Cd 


10h 


OOh if VGA color mode 

Oih if VGA monochrome mode 
Memory available, where: 

OOh = 64K available 

Oth = 128K available 

02h = 192K available 

O3h = 256K available | 


Adapter bits 
Switch settings 


The references to adapter bits and switch settings are retained only for 
historical reasons. The VGA hardware is not affected. VGA hardware 
simulates earlier adapter cards in software rather than in hardware. IBM- 
compatible VGA hardware only gives a software emulation of switches. 
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Function: AH = 12h Alternate Select, Continued 


Subfunction: BL = 10h Return VGA information, cont’d 


Adapter bits are set from Input Status register 0, responding to output on a 
given Adapter Control register bit. 


Adapter Control Output 
Adapter Bit No. Bit Setting Input Status Bit No. 


The bits of the switch settings byte give the settings of the EGA’s configura- 
tion DIP switch (where 1 = off, 0 = on). Color = O9h and monochrome = 


OBh. 


Configuration switch 1 | 


Configuration switch 2 
Configuration switch 3 


Configuration switch 4 


Subfunction: BL = 20h Switch to alternate print screen routine 


This subfunction sets the INT 05h Print Screen service to the proper alternate 
Print Screen vector. The default BIOS print screen routine assumes a screen 
length of 25 lines. This subfunction allows an alternative routine to be se- 
lected that supports a screen length other than 25 lines. 


Input: AH = 12h 
BL = 20h 
Output: None 
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Function: AH = 12h Alternate Select, Continued 


Subfunction: BL = 30h Select scan lines for text modes 
(takes effect on next mode set) 
This subfunction sets the number of scan lines to be displayed in text 


modes. By default, the BIOS sets all text modes to 400 scan lines as part of 
the power-on self test and initialization (POST) process. 


Models 25 and 30: This subfunction is not available on IBM PS/2 Models 25 
and 30 and compatibles with MCGA hardware. 


Input: AH 
AL 
BL 

Output: AL 

Notes: 


12h 

Number of scan lines, where 
OOh = 200 scan lines 

Oih = 350 scan lines 

02h = 400 scan lines 

30h 


12h Function is supported 


» The number of scan lines indicated in AL will take effect upon the next 


mode set. 


= The BIOS loads the font associated with the mode/scan line combination 
upon the next mode set. 

# 200-line scan modes are double-scanned. Each video line is painted 
twice before the next new line is begun. 


Subfunction: BL = 31h Enable/Disable default palette loading during set mode 


If Disable Default Palette Loading is selected, no updates are made to the 
overscan color register, the attribute color registers or the DAC color regis- 
ters when a video mode is set. 


Input: AH 

AH 

AL 

BL 

Output: AL 
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12h 
OOh 
OOh Enable default palette loading 
Oih Disable default palette loading 
31h 


12h Function supported 
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Function: AH = 12h Alternate Select, Continued 


Subfunction: BL = 32h Enable/Disable video 


This subfunction enables/disables the video I/O port regenerator and the 
display buffer address decode for the currently active video monitor. 


Input: AH = 12h 
AL = OOh Enable video 
= Oth Disable video 
BL = 32h 
Output: AL = 12h Function supported 


Subfunction: BL = 33h Enable/Disable summing to gray shades 


This subfunction enables/disables gray scale summing that occurs during 
Mode Set (AH = OOh) and during Set Palette Registers (AH = 10h) for the 
display that is Currently active. 


Input: AH = 12h 
AL = OOh Enable summing 
= Oth Disable summing 
BL = 33h 
Output: AL = 12h Function is supported 


Subfunction: BL = 34h Enable/Disable cursor scaling 


When cursor scaling is enabled (which is the power-on default), cursor start 
and end information is scaled to the current character height. See INT 10h, 
AH = O1h Set Cursor Type for more information on setting cursor type. 


Models 25 and 30: This function is not available on IBM PS/2 Models 25 and 
30 and compatibles with MCGA hardware. 


Input: AH = 12h 
AL = OOh Enable cursor scaling 
= Oth Disable cursor scaling 

BL = 34h 
Output: AL = 12h Function is supported 
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Function: AH = 12h Alternate Select, Continued 


Subfunction: BL = 35h Switch Display 


When there is a conflict between the system video and an adapter video 
(i.e. overlapping usage of the CBIOS data area and/or hardware capabili- 
ties), the adapter video is the power-up default primary video. The system 
board video remains inactive until switching has been enabled. 


To be able to switch, the Disable Video subfunction (AH = 12h, BL = 32H) 

must be supported by both the adapter and the system board. 

= To enable video switching, first call with BL = 35h and AL = OOh to disable 
the adapter video, then call with AL = 01h to enable system board video. 

» Once switching has been enabled, all subsequent switches are done 


through AL = 02h Disable Active Video and AL = O3h Enable Inactive 
Video. 


Input: AH = 12h 
AL = OOh Turn off initial video adapter, must have 128-byte 
| save area pointed to by ES:DX 
= Qth Turn on initial system board video 
= Q2h Disable active video, must have save buffer pointer in 
ES:DX 
= OQ3h Enable inactive video, must have ES:DX pointer to 
7 previously filled save buffer 
‘BL = 35h 
Output: AL = 12h function supported 


When there is no conflict between the system video and an adapter video 
board, both video devices are active and use of the display switch subfunc- 
tion is not necessary. 


Subfunction: BL = 36h Video screen ON/OFF 
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This subfunction turns the video screen on or off. 


Models 25 and 30: This function is not available on IBM PS/2 Models 25 and 
30 (and compatibles) with MCGA hardware. 
Input: AH = 12h 

AL = Oth Screen OFF 


= OOh Screen ON 
BL = 36h 


Output: AL = 12h Function supported 
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Function: AH = 13h Write String 


Description 


The Write String function operates similarly to Write Teletype (AH = OEh), 
except that an entire string is handled with each call. The AL register con- 
tains two single—bit fields as follows: 


pe fmm 
AL Bit 0 = 1 the cursor remains at the last character written. 


AL Bit 0 = 0 the cursor is restored to where it was before the “write string” 
operation began. 
AL Bit 1 = 1 each string character to be displayed is followed by its attribute. 


AL Bit 1 = 0 carriage return, line feed, backspace, and bell are interpreted as 


commands rather than as printable characters. The string con- 
tains only display characters, and the attribute is taken from the 
BL register. 


Input/Output 
Input: AH = 13h 

ES:BP = Pointer to start of string 
BH = Page number (for text modes) 
BL = Attribute for characters (graphics modes) 
CX = Length of string (attributes don’t count) 
DX = Starting cursor position (DH = row, DL = column) 
AL = Flags (see above) 


Output: None 


Functions: AH = 14h - 19h Reserved 
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Function: AH = 1Ah Read/Write Display Combination Code 


Description 


‘}o.4 @2h sds Color Graphics Adapter (CGA) with color monitor 


The Read/Write Display Combination Code service has two subfunctions, one 
devoted to reading the display codes and one devoted to writing the display 
combination codes. In either case, the display code for the active monitor is 


specified in BL. The display code for the inactive monitor (if any) is specified 
in BH. 


The display codes corresponding to the monitors are listed below. 


Description 


| ooh sd No display attached 
Monochrome Display Adapter (MDA) with monochrome monitor 


| Oh Reserved 

[04m | Enhanced Graphics Adapter (EGA) with color mentor —__—_| 
[05m | EGA with monochrome moniter 
[08h | Professional Graphics Adapter (PGA) with color mentor 
| oh 
Pp oeh 


03h 
04h 
05h 
06h 
o7h 
[taro Revved SCSC~C~*” 
I IN atlas aera 
| monitor | 


Subfunction: AL = 00h Read display combination code 
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Input: AH = 1Ah 


AL = OOh 

Output: AL = 1Ah Function supported 
BH = Inactive display code 
BL = Active display code 
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Function: AH = 1Ah Read/Write Display Combination Code, Continued 


Subfunction: AL = 01h Write display combination code 
Input: AH = 1Ah 


AL = Oth 
BH = Alternate display code (if any) 
BL = Active display code 

Output: AL = 1Ah — Function supported 


Function: AH = 1Bh Return Functionality/State Information 


Description 


The Return Functionality/State Information function outputs a table describing 
the current state of the video hardware to a 40h-byte buffer location pointed 
to by ES:DI. 


Input/Output 
Input: AH = 1Bh 
BX = 0000h Implementation Type 
ES:DI = Pointer to 40h byte buffer 
Output: AL = 1Bh — Function successful 


Functionality/state information is output to 40h—byte buffer (see description 
on the following page. 


Error conditions 


The CBIOS will accept only one implementation type: BX = OOOOh. If a value 
other than O0OOh is input into BX, this function returns the following values: 


» AH = 1Bh 
» AL = OOh 
= All other registers are preserved. 
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Function: AH = 1Bh Return Functionality/State Information, 
Continued 


Structure of the Functionality/State Table 
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Function AH = 1Bh places the functionality and state of the current video 
environment in a 40h-byte table pointed to by ES:DI. The structure of the 
40h-byte Functionality/State Table is detailed below: 


DI+00h Dword Segment/offset of static functionality table fixed 
address 

DI+04h 1 Byte Video Mode (See the Video Modes table in this 
chapter for supported video modes) 

DI+07h Display buffer length 


Di+29h Display pages supported for current video mode 
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Function: AH = 1Bh Return Functionality/State Information, 


Continued 


Structure of the Functionality/State Table, cont’d 


DI+2Ah 
DI+2Bh 


DI+2Ch 


DI+2Dh 


DI+2Eh 
DI+2Fh 
Dl+30h 
Dl+31h 


Di+32h 


DI+33h-3Fh 


1 Byte 


1 Byte 


1 Byte 


1 Byte 
1 Byte 
1 Byte 
1 Byte 


1 Byte 


13 Bytes 


Scan lines in current video mode 00b = 200 
scan lines 01b = 350 

scan lines 10b = 400 

scan lines 11b = 480 

scan lines 100b - 11111111b 

Reserved 


Primary character block 
0Ob = Block 001b 
= Block 110b 
= Block 2 - 11111111b 
= Block 255 


Secondary character block 


00b = Block 001b 
= Block 110b 
= Block 2 - 11111111b 
= Block 255 


Miscellaneous state information 
Bits 7-6 = Reserved 


Bit 5 = 0 Background intensity 
= 1 Blinking 
Bit 4 = 1 Cursor emulation is active 
Bit 3 = 1 Mode set auto palette loading disabled 
Bit 2 = 1 Mono display is attached 
Bit 1 = 1 gray scale summing is active 
Bit 0 = 1 All modes on all displays active 


Reserved 
Reserved 
Reserved 


Video memory available 


00b = 64K 

Oib = 128K 
106 = 192K 
11ib = 256K 


Save pointer state information 


Bits 7-6 = Reserved 

Bit 5 = 1 Display Combination Code (DCC) 
extension active 

Bit 4 Palette override active 

Bit 3 Graphics font override active 

Bit 2 Text mode font override active 

Dynamic save area active 

512-character character set active 


Bit 1 
Bit 9 


Reserved 


fou td uw ul 
ree eee Ge ee 


INT 10h Video Service 


continued 


239 


Function: AH = 1Bh Return Functionality/State Information, 
Continued 


Structure of the Static Functionality Table 


The first entry in the Functionality/State Table is a double word pointer to a 
16-byte ROM-—based Static Functionality Table. 


The Static Functionality Table contains fixed video parameter information. To 
insure compatibility, the static functionality table is located at EQ00:305Fh in 
the CBIOS. The contents of the Static punewonay Table are defined below. 


Oftset Description 


Video modes ainfaned: 


Bit 7 = 1 Mode 7 supported 
1 Mode 6 supported 
1 Mode 5 supported 
1 Mode 4 supported 
Mode 3 supported 
1 
1 


Mode 2 supported 
Mode 1 supported 
Mode 0 supported 


Video modes supported, Continued 


Bit 7 = 1 Mode F supported 
Bit 6 = 1 Mode E supported 
Bit 5 = 1 Mode D supported 
Bit 4 = 0 Mode C supported 
Bit 3 = 0 Mode B supported 
Bit 2 = 0 Mode A supported 
Bit 1 = 0 Mode 9 supported 
Bit O = 0 Mode 8 supported 


Video modes supported, Continued 
Bits 7-4 = Reserved 


07h 07h 


Bit 3 = 1 Mode 13 supported 
aN ' 1 Mode 12 supported 
t 


Scan line modes available for text modes 


Bits 7-3 = 00000b Reserved 

Bit 2 = | 400 scan lines supported 
Bit 1 = 1 350 scan lines supported 
Bit O = 1 200 scan lines supported 


: 1 Mode 11 supported 
= 1 Mode 10 supported 
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Function: AH = 1Bh Return Functionality/State Information, 


Continued 


Structure of the static functionality table, cont’d 


ae a el Number of character blocks available in text modes 


OAh | FFh 


OBh OEh 


OEh 3Fh 


a 


Maximum number of active character blocks avail- 
able in text modes 


Miscellaneous 
1 Color paging supported 


Bit 7 
Bit 6 
Bit 5 
Bit 4 
Bit 3 
Bit 3 
Bit 2 
Bit 1 
Bit 0 


1 Color palette supported 

1 EGA palette supported 

1 Cursor emulation supported 

1 Cursor emulation supported 

1 Default palette loading supported 

1 Character font loading supported 

1 gray scale summing supported 

1 All modes on all displays supported 


Miscellaneous, Continued 
Bits 7-4 = 0000b Reserved 


Bit 3 = 1 Display combination codes (DCC) 
supported 
Bit 2 = 1 Background intensity/blinking control 
: supported 
Bit 1 = 1 Save/restore supported 
Bit O = 0 Light pen not supported 


Reserved 


Save pointer functions 
Bits 7-6 = 00b Reserved 


Graphics font override 
Alpha font override 
Dynamic save area 


12 Character set supported 


Reserved 
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Function: AH = 1Ch Save/Restore Video State 


Introduction 


At any time, the savable portion of the current video state consists of three 
discrete parts: | 


Hardware State The contents of the CRT, Attribute, and Graphics Con- 
troller registers 
Video BIOS State Those areas in the BIOS Data Area in system RAM con- 
| taining video information 


Digital/Analog | The contents of the DAC control and color registers 
Converter (DAC) State 


Description 


The Save/Restore Video State function consists of three subfunctions that 
enable the user to save (and subsequently restore) any or all of the three 
states making up the current video state. 


Video state information is stored in system RAM buffer pointed to by ES:BX. 
The video states (i.e. hardware/BIOS/DAC) to save or restore are selected in 
CX by setting or clearing Bits 2-0. 


Save/Restore video state subfunctions 


Each of the three Save/Restore Video State subfunctions is selected via the 
AL register. The table below lists the three subfunctions: 


AL Value Subfunction Name 


Return Save/Restore buffer size needed 
Save current video state | 
POH Restore current video state 


Models 25 and 30: This function is not supported on IBM PS/2 Models 25 
and 30 (and compatibles) with MCGA hardware. If called, no action is 
performed. | 


continued 
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Function: AH = 1Ch Save/Restore Video State, Continued 


Error handling 


Upon entry into the Save/Restore Video State function, the CBIOS checks the 
parameter passed in the AL register. If it is out of range (i.e. greater than 
O2h), then the function returns with AL = OOh and AH preserved. 


Buffer format for save/restore video state 


The save buffer is composed of a 20h-byte Fixed Offset Area followed by 
one, two, or three optional areas, depending on which areas (hardware/ 
BIOS/DAC) were specified in CX. 


The 20h-byte fixed offset area contains the following information: 


Description 


Word offset of hardware save area, if saved 


Word offset of BIOS RAM save area, if saved 


Word offset of DAC save area, if saved 


Reserved 


| O6h-1Fh 


Subfunction AL = 00h Return save/restore buffer size needed wy 


This subfunction returns the buffer size (in 64—byte blocks) needed for any 
combination of the three video states that can be stored. The video state (or 
combination of video states) is specified in CX; the buffer size in 64-—byte 
blocks is returned in BX. 


Input: AH = 1Ch 
AL = OOh 
CX = Video state to store, where: 
Bit O = 1 Save video hardware state 
Bit 1 = 1 Save video BIOS data area 
Bit 2 = 1 Save video DAC state and color registers 
| Bits 3-15 = 0 Reserved 
Output: AL = 1Ch Function is supported 
BX = Buffer size block count (1 block = 64 bytes) 


/ continued 
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Function: AH = 1Ch Save/Restore Video State, Continued 


Subfunction: AL = 01h Save current video state 


This subfunction stores the video states specified in CX to a system RAM 
buffer area pointed to by ES:BX. 


input: AH = 1Ch 
AL = Oth 
CX = Video state to store, where: 
Bit O = 1 Save video hardware state 
Bit 1 = 1 Save video BIOS data area 
Bit 2 = 1 Save video DAC state and color registers 


Bits 3-15 = O Reserved 
ES:BX = Pointer to system RAM buffer 


Output: AL = 1Ch Function is supported 


Warning 


Saving a video state alters the original contents of the registers or data 
areas involved. To maintain the current video state, execute the Re- 
store Video State subfunction immediately after saving the video state. 


Subfunction: AL = 02h Restore current video state 


This subfunction restores the video states specified in CX from the system 
RAM buffer area pointed to by ES:BX. 


input: AH = 1Ch 
AL = 02h 
CX = Video state to restore, where: 
Bit O = 1 Save video hardware state 
Bit 1 = 1 Save video BIOS data area 
Bit 2 = 1 Save video DAC state and color registers 


Bits 3-15 = 0 Reserved 
ES:BX = Pointer to previously saved system RAM buffer 


Output: AL = 1Ch Function is supported 


continued 
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Function: AH = 1Ch Save/Restore Video State, Continued 


Structure of hardware state save area 


If Bit O of the CX register is set and the Save Video State subfunction is 
executed, then current hardware state is stored to the system RAM buffer 
pointed to in ES:BX. Executing the Restore Video State subfunction with the 
same CX and ES:BX values restores the hardware state information to the 
actual video hardware. 


The structure of the hardware state save area is as follows: 


Description 


ro Sequencer Index 
| oth a CRT Controller Index 


[—eraptioe Conirar dee 
Se 
[oan [Map mask 


Character Map Select 


08h 03C5h } 04h | Memory Mode 
| 00h | Miscellaneous Output 


* 03B4h in Monochrome Emulation Modes 
03D4h in Color Emulation Modes 


continued 


INT 10h Video Service 245 


Function: AH = 1Ch Save/Restore Video State, Continued 


Structure of hardware state save area, cont’d 


offset 1/O Address index Description 


CRT CONTROLLER REGISTERS 


3B5h/3D5h* Oth Horizontal Total | 
3B5h/3D5h* Horizontal Display Enable End 
3B5h/3D5h* Start Horizontal Blanking 


>) 


Ah 
Bh 
Ch 
Dh 


io) 


| 3B5h/3D5h* End Horizontal Blanking 
3B5h/3D5h* Start Horizontal Retrace Pulse 
3B5h/3D5h* End Horizontal Retrace 


Oo 


Fh 
10h 
1th 
12h 
13h 
14h 


3B5h/3D5h* Vertical Total 


07h 


3B5h/3D5h* CRTC Mode Control 


3B5h/3D5h* Line Compare 
* 03B5h in Monochrome Emulation Modes 
03D5h in Color Emulation Modes 


continued 


3B5h/3D5h* 
3B5h/3D5h* 
3B5h/3D5h* 
3B5h/3D5h* 
3B5h/3D5h* 
3B5h/3D5h* 
17h 3B5h/3D5h* 
3B5h/3DSh* 
3B5h/3D5h* 
3B5h/3D5h* 
3B5h/3D5h* 
3B5h/3D5h* 
3B5h/3D5h* 
3B5h/3D5h* 
3B5h/3D5h* 
3B5h/3D5h* 


OAh 

OAh 

OBh 

0Ch 

_OFh 
1Ah 
1Bh 
1Ch 
1Dh 

14h 

17h 


1Eh 
1Fh 
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Function: AH = 1Ch Save/Restore Video State, Continued 


Structure of hardware state save area, cont’d 


| oftsct 1/O Address F indox | Description 


ATTRIBUTE CONTROLLER REGISTERS 


[_arrnavre conTRonienncasTens 
a ee a 

[wscrn [on | Seve 
arephics Mode Regier 


Se vee Base Address Low 
CRTC Base Address High 
Plane 0 System Latch 


Plane 1 System Latch 
Plane 2 System Latch 
Plane 3 System Latch 
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Function: AH = 1Ch Save/Restore Video State, Continued 


Structure of video BIOS state save area 


If Bit 1 of the CX register is set and the Save Video State subfunction is 
executed, then the current video BIOS state is stored to the system RAM 
buffer pointed to in ES:BX. Executing the Restore Video State subfunction 
with the same CX and ES:BX values restores the video BIOS state informa- 
tion in its location in the BIOS Data Area (O0400h-0500h) in system RAM . 


Video data definitions 


The data definitions used by the INT 10h Video services are stored in system 
RAM in segment 40h and are Presence below. 


ae ae | 1 Byte | Video mode setting. 
Number of columns on screen. 

8 Words Cursor position on each page. Two bytes/page. 
First byte (low order) of each pair is column, sec- 
ond is row. 0, 0 is upper left corner of screen. 
starting and ending scan lines. High-order byte 

holds starting scan line; low-order byte holds end- 


1 Word 
| Ing scan line. 


Cursor type defined as 6845 video chip-compatible 


Current page number. 
1 Word 6845-compatible {/O port number for current 
mode. (Port 03D4h or 03B4h) 
Current mode select register. 


1 Byte Current palette value. 
Number of rows on screen (24 or 25) 


Character height (py teesenaracter) 


continued 
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Function: AH = 1Ch Save/Restore Video State, Continued 


Video data definitions, cont’d 


Video control bits, where: 


Bit 7 = Clear RAM 
Bit 6,5 =Memory on video hardware as follows: 
00 4K 


Not used 
0 If EGA-compatible mode is active 
0 Wait for display enable 
0 If color or ECD monitor is 
attached to EGA-compatible adapter 
= 1If Monochrome monitor is attached to 
EGA-compatible adapter 
= 0 If translate cursor video modes 
0-3 when using ECD monitor in 
350 line mode 


EGA/VGA switch data where: 


| Bits 7-4 = Feature connector bits 3-0, respectively 
Bits 3-0 = Option switches 3-0, respectively 


VGA control bits, where: 


Bit 7 = 200 lines 
Bits 6-5 = Reserved 
Bit 4 = 400 lines 

| Bit 3 = No palette load 
Bit 2 = Mono monitor 
Bit 1 = Gray scalling 
Bit O = Reserved 


Index to the Display Combination Code table 


| 1 Word Pointer to video parameter table and overrides (in 
segment: offset format). | 


5 


continued 
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Function: AH = 1Ch Save/Restore Video State, Continued 


Structure of DAC state save area 


lf Bit 2 of the CX register is set and the Save Video State subfunction is 

executed, then the current state of the DAC is stored to the system RAM 
buffer pointed to in ES:BX. Executing the Restore Video State subfunction 
with the same CX and ES:BX values restores the DAC information to the 

actual DAC hardware. 


The structure of the DAC state save area is as follows: 


[cn | acm |__| enaiwrte mode DAG 
eS 
a 
eon | ed vane coor 
a 

Toon | ue vate colo 

Toim | ed vane color 

i i Tai 
Fn 

Fen 

Fen 

Can 


Function: AH = 1Dh —- FFh Reserved 
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Chapter 10 
INT 13h Diskette Service 


Overview 


Description 


The CBIOS Diskette Service performs BlOS-level read, write, format, diag- 
nostic, initialization and other operations for up to two internal diskette 
drives. 


How diskette services are invoked 
The CBIOS Diskette Service is invoked via software INT 13h. 


The CBIOS initializes the INT 13h Diskette Service vector to FOOO:E3FEh, the 
IBM—compatible entry point. The INT 13h vector resides at address 00:4Ch in 
the Interrupt Vector Table. 


The CBIOS Diskette Service has eleven functions. Individual functions are 
selected via the AH register. 


continued 
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Overview, Continued 


When a fixed disk is present 


When a fixed disk is installed, the CBIOS automatically redirects all INT 13h 
Diskette Service requests to INT 40h. This redirection is transparent to end 
users. End users should continue to invoke INT 13h for both diskette and 
fixed disk services. 


For a discussion of the CBIOS Fixed Disk Service, refer to Chapter 11 of this 
volume. 


Summary of diskette functions 
The following table summarizes Diskette Service functions: 


Description 


a Reset Diskette System 
pth Read Diskette Status 


om dey inte Sectors 
ora te rk 
a OL 
a 
a 
a a 


Set Diskette Type 
Set Media Type for Format 


continued 
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Overview, Continued 


In this chapter 
This chapter focuses on the CBIOS Diskette Service INT 13h. The following 
topics are discussed: 
» Hardware Environment 
= Diskette Service I/O Ports 
= System RAM Data 
» CMOS RAM Data 
= ROM BIOS Data 
» Error Handling 
=» Rules for Using CBIOS and ABIOS Diskette Services 
» Diskette Service Functions 
»s INT OEh Diskette Hardware Interrupt 
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Hardware Environment 


Hardware assumed 


The NEC 765 diskette controller chip (or its equivalent) is used to control the 
internal and external diskette drives. 


How diskette drives are identified 


Each diskette drive must be identified to the system with a unique number. 
There are only two valid diskette numbers: 


» Diskette drive 0 is number O 
=» Diskette drive 1 is number 1 


These values must be in DL for most Diskette Service functions. 


Supported drive types 


The CBIOS Diskette Service supports six types of diskette drives: 


Drive Type Media type 


1.44 MB 
720K 


360K 
320K 
720K 


1.2 MB 


360K diskette format compatibility 


CBIOS supports 8 or 9 sectors per track and either single-sided or double- 
sided diskette drives. 360K is the maximum data storage capability for stan- 


dard double-density diskette drives. 320K, 160K, or 180K diskette capabili- 
ties are also supported. 


continued 
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Hardware Environment, Continued 


5.25 inch diskette compatibility 


5.25 inch diskette media can be high density (1.2 MB) or double density 
(360K). Diskettes written on one type of 5.25 inch drive may or may not 
be written on or read from using the other type. The following table outlines 
the possible read/write combinations of 5.25 inch diskette media and drive 


types. 
If diskette was Then it can be And it can be 
formatted on... | read on... written to by... 


Media Type 


360K 360K drive 360K drives 1.2 MB drives | 360K drives only 
) 1.2MB 360K drive 360K drives 1.2 MB drives | 360K drives only 


lf a high density (1.2 MB) diskette is formatted on a 1.2 MB drive, then it 
can be read on and written to by 1.2 MB drives only. 


The DOS command, format/4, can be used to format a 360K diskette in a 
1.2 MB drive. Both 1.2 MB and 360K drives can generally read and write 
these diskettes. 


3.5 inch diskette compatibility 


The following outlines the possible read/write combinations for 3.5 inch 
drives and media: 


« If a 720K media type diskette is formatted on a 720K drive, then it can be 
read on either 720K or 1.44 MB drives, but it can only be written to by 
720K drives. 


= If a 1.44 MB media type diskette is formatted on a 1.44 MB drive, then it 
can be read on and written to by 1.44 MB drives only. 


continued 
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Hardware Environment, Continued 


Data transfer rates 
All supported formats use a 512-byte sector size. Data transfer rates are: 


Diskette Capacity Drive Capacity Drive Size 
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Diskette Service I/O Ports 


Read/Write 
1/O Address Status Description 


0004h DMA channel 2, memory address register 
| 0005h_— DMA channel 2, transfer count register 


R/W 
R/W 
OO0Ah DMA channel 0-3, mask register, where: 


Bits 7~3= 0 Reserved 
OOOBh 


Bit 2 = 0 Clear mask Bit 


00b Select channel 0 
01b Select channel 1 
10b Select channel 2 
11b Select channel 3 


DMA channel 0-3, mode register, where: 


Bits 7-6= 00b Demand mode 
= 01b Signal mode 
10b Block mode 
1ib Cascade mode 
Address increment select 


Bit 5 = 
= 1 Address decrement select 
Bit 4 = 0 Autoinitialization disable 
= 1 Autoinitialization enable 
Bits 3-2= 00b Verify operation 
= O1b Write to memory 
Ob Read from memory 
1b Reserved . 
Bits 1-O= 00b Channel 0 select 


Ob Channel 2 select 
1b Channel 3 select 


DMA Clear Byte Pointer 
CMOS RAM address register port 
CMOS RAM data register port 


DMA channel 2, page register 


1 
1 
0 
Tob Channel 1 select 
1 


1 Set mask Bit 
Bits 1-0 
0070h 
0071h 


0081h 


O3F0h Diskette controller status register A, where: 
Bit 7 = 1 Interrupt pending 
Bit 6 = 0 Second drive installed 
Bit 5 = 1 Step 
Bit 4 = 1 Track 0 
Bit 3 = 1 Head 1 select 
Bit 2 = 0 Index 
Bit 1 = 0 Write protect 
Bit 0 = 1 Direction 
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Diskette Service I/O Ports, Continued 


Read/Write 
1/O Address Status Description 


Diskette controller status register B, where: 


Bit 7 = 0 Reserved 
Bit 6 = 0 Reserved 
Bit 5 = 0 Drive 0 select 
Bit 4 Write data 
Bit 3 ead data 


Bit 2 
Bit 1 
Bit 0 


Motor enable 1 
Motor enable 0 


R 
1 Write enable 
1 
1 


Diskette controller digital output register, where: 


Bit 7 = 0 Reserved 

0 Reserved 

1 Motor enable 1 
1 Motor enable 0 
0 Reserved 

: Controller reset 
0 

1 


Reserved 
Drive select 0 
Drive select 1 


Bit 7 = 1 Data register is ready for transfer 

Bit 6 = 1 Transfer is from controller to system 
= 0 Transfer is from system to controller 

Bit 5 = 1 Non-DMA mode 

Bit 4 = 1 Diskette controller busy 

Bit 3 = 0 Reserved 

Bit 2 = 0 Reserved 

Bit 1 = 1 Drive 1 busy 

Bit O = 0 Drive 0 busy 


Digital input register, where: 


Bit 7 = 1 Diskette change 
Bits 6-1 = Reserved 
Bit O = 0 High density select 


Diskette controller configuration control register, 
where: 


Bits 7-2 = Reserved 
Bits 1-0 = 00b 500 Kbs mode 
01b 300 Kbs mode 
10b 250 Kbs mode 
11b Reserved 
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System RAM Data 


System RAM data area table 


The CBIOS Diskette Service references control data stored in the CBIOS Data 
Area (400h-500h). All Diskette Service items are defined in the table below. 


Number of devices installed, where: 


Bits 15-14 = Number of printer adapters 
Bits 13,12 = Reserved 
Bits 11-9 = Number of asynchronous adapters 
(RS232) 
Bit 8 = Reserved 
Bits 7-6 =WNumber of diskette drives, where: 
O00b= 1 diskette drive 
O1b= 2 diskette drives 
Bits 5-4 = Initial video mode, where: 
00b= EGA or PGA 
01b= 40x25 color 
10b= 80x25 color 
11b= 80x25 black and white 
= Reserved 
= Pointing device installed 
= 1 Math coprocessor installed 
= Diskette available for boot 


Diskette drive recalibration status, where: 


Bit 7 = 1 Diskette hardware 
interrupt has occurred 

Bits 6-4 = Not used 

Bits 3,2 = Reserved 

Bit 1 = Recalibrate drive 1 

Bit O = Recalibrate drive 0 


Diskette drive motor status, where: 


Bit 7 1 Current operation is a write or format 
0 Current operation is a read or verify 
= Reserved 
= Drive select status where: 
O0b= Drive 0 selected 
Oib= Drive 1 selected 
10b= Reserved 
11b= Reserved 
= 1 Drive 1 motor is on 
= 1 Drive 0 motor is on 


40:40h | 1 Byte Diskette motor time-out count 
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System RAM Data, Continued 


System RAM data area table, cont’d 


40:41h 1 Byte Diskette status return code, where: 

Bit 7 = 1 Drive not ready. 

Bit 6 = 1 Seek error occurred 

Bit 5 = 1 Diskette controller failed 

Bits 4-0 = Error codes, where: 
O1h= Illegal function requested 
O2h= Address mark not found 
O3h= Write protect error 
04h= Sector not found 
O6h= Drive door was opened 
O8h= DMA overrun error 
09h= DMA boundary error 

| OCh = Media type unknown 

10h= CRC failed on diskette read 


| 40:42h 7 Bytes Diskette controller status bytes 


40:74h 1 Word Status from last fixed disk operation, where: 
00h = No error 
Oth = Invalid function request 
02h = Address mark not found 
03h = Write protect error 
04h = Sector not found 
05h Reset failed 

| Drive parameter activity failed 
| O8h DMA overrun on operation 

09h = Data boundary error 
OAh = Bad sector flag detected 
OBh = Bad track detected 
ODh = Invalid number of sectors on format 
OEh = Control data address mark detected 
OFh = DMA arbitration level out of range 
10h = Uncorrectable ECC or CRC error 
11h = ECC corrected data error 
20h = General controller failure 
40h = Seek operation failed 
80h = Time-out 
AAh = Drive not ready 
BBh = Undefined error occurred 
CCh = Write fault on selected drive 
EOh = Status error/error register is 0 
FFh = Sense operation failed 


40:75h_ Number of fixed disk drives 
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System RAM Data, Continued 


System RAM data area table, cont’d 


40:8Bh 2 Bytes Diskette data rate information 

Bits 7,6= Last data rate set by controller, 
where: 
00b = 500 Kilobytes/second (Kbs) 
01b = 300 Kbs 
10b = 250 Kbs 
11b = Reserved 
Last diskette drive step rate selected 
Data transfer rate at operation start, 
where: 
00b = 500 Kbs 
01b = 300 Kbs 
10b = 250 Kbs 
11b = Reserved 

Bits 1,0= Reserved 


40:8Fh 1 Byte Diskette controller information, where: 

Bit 7 = Reserved 

Bit 6 = 1 Drive determined for drive 1 
Bit 5 = 1 Drive 1 is multirate 

Bit 4 =1 Drive 1 supports change line 
Bit 3 - Reserved 

Bit 2 = 1 Drive determined for drive 0 
Bit 1 = 1 Drive 0 is multirate 

BitO | =1 Drive 0 supports change line 


40:90h-91h Media Type of Both Drives: 


(One byte per drive. drive 0 at 40:90h; drive 1 at 
40:91h) 
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Bits 7,6 = Data Transfer Rate, where: 
00b = 500 Kbs 
01b = 300 Kbs 
10b = 250 Kbs 
Bit 5 = 1 Double stepping required 
(360K media/1.2 MB drive) 
Bit 4 = 1 Known media in drive 
Bit 3 = Reserved 
Bits 2-0 = Definitions on return to user: 
111b = 720K media in 720K or 1.44 MB 
drive; or 1.44 MB media in 
1.44 MB drive 
101b = Known 1.2 MB media in 1.2 MB 


drive 

100b = Known 360K media in 1.2 MB 
drive 

011b = Known 360K media in 360K drive 

010b = Trying 1.2 MB media in 1.2 MB 
drive 

001b = ee 360K media in 1.2 MB 


rive 
000b = Trying 360K media in 360K drive 
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System RAM data area table, cont’d 


40:92h 2 Bytes Diskette Service work area. Each entry is first 
FDMED value tried. One byte per drive. Drive 0 
at 92h, Drive 1 at 93h. 

40:94h 2 Bytes Current track number for both drives. One byte 
per drive. Drive 0 at 94h, drive 1 at 95h. 


40:A0h 2 Bytes | Walt active flag, where: 
| Bit 7 =1 Wait time elapsed 
Bits 6-1= Reserved 
, BitO =1 INT 15h, AH = 86h occurred 
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CMOS RAM Data 


Introduction 


The Diskette Service routine makes use of control information located in 
CMOS RAM data areas OEh through 10h. The table below provides detailed 
information about the areas used. 


CMOS RAM data area table 


The following table describes all CMOS RAM data areas used by this 


interrupt. 


CMOS RAM 
Offset (hex) Description 


ae 
a = 


INT 13h Diskette Service 


Diagnostic status, where: 


Bit 7 = 1 Real time clock lost power 

Bit 6 = 1 CMOS checksum is bad . 
Bit 5 = 1 Invalid configuration information at POST 
Bit 4 = 1 Memory size compare error at POST 


Bit 3 = 1 Fixed disk or adapter fails initialization 
Bit 2 = 1 CMOS time found invalid 

Bit 1 = 1 Adapters do not match configuration 
Bit 0 = 1 Time-out in reading an adapter ID 


Type of diskette drives: 


Bits 7-4 = Drive type of drive 0, where: 
0000b = No drive 
0001b = 360K drive 
0010b = 1.2 MB drive 
0011b = 720K 


0100b = 1.44 MB 

Bits 3-0 = Drive type of drive 1, where: 
0000b = No drive 
0001b = 360K drive 
0010b = 1.2 MB drive 
0011b = 720K 
0100b = 1.44 MB 
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ROM BIOS Data 


Introduction 


The diskette device service routine in PC XT/AT systems supplied a table of 
parameters used to manipulate diskette drives. For compatibility, the CBIOS 
Diskette service must still provide the same table, although some of its 
values are modified so that the table is more suited to the default 3.5-inch 
1.44 MB diskette drives. The default 11-byte table is located in ROM at 
FOOO:EFC7h and is pointed to by the interrupt 1Eh vector. 


Parameter table 


The format for the first data byte of the diskette specify 
command is: 


Bits 7-4 = Stepping rate 
Bits 3-0 = Head unload time 


The default stepping rate is OAh for the 1.44 MB drive with a 
1.44 MB diskette inserted. The default head unload time is the 
maximum value of 240 ms (OFh). 


The format for the second data byte of the diskette specify 
command is: 


Bits 7-1 = Head load time 
Bit 0 = Non-DMA mode flag 


The default head load delay time is set to the minimum value of 
~4ms (01h). The heads are loaded at the same time as the mo- 
tor is started, but the motor delay is much longer so the head 
load time delay is not really needed. The non-DMA mode flag is 
always set to zero to indicate that DMA is being used. 


Motor turn-off delay. This is the amount of time in timer ticks 
that the diskette device service routine waits before turning off 
an inactive diskette drive motor. Timer ticks occur 18.2 times 

per second and the routine waits about two seconds; therefore 
the default value for this field is 25h. 


Bytes per sector. This field is encoded in the following way to 
match the encoding used by the diskette controller: 


00 = 128 bytes per sector 
01 = 256 bytes per sector 
02 = 512 bytes per sector 
03 = 1024 bytes per sector 


The standard sector size is 512 bytes per sector, so the default 
value for this field is 02h. 


End of track. Since the sector numbering is one relative, this 
field is actually the number of sectors per track. For a 1.44 MB 
diskette in the 1.44 MB drive, this field is 18 sectors per track. 
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ROM BIOS Data, Continued 


Parameter table, cont’d 


Gap length. This field Is the length of the gap between sectors. 

The default value for this field is 1Bh for a 1.44 MB diskette. 
Data Length. Since the bytes per sector field is non-zero, this 
field is meaningless and is set to FFh. 


Gap length for format. This field is the length of the gap be- 
tween sectors to maintain when formatting. The default format 
gap length for a 1.44 MB diskette is 6Ch. 


Filler byte. This byte is the format filler byte and is F6h. 


Head seek delay time. This is the amount of time in milliseconds 
the diskette device service routine must wait for the heads to 
settle after doing a seek operation. For the 1.44 MB diskette 
drive, this field is OFh. 


Motor start time. This is the amount of time in eighths of a sec- 
ond that the diskette device service routine must wait for the 
motor to come up to speed before doing an I/O operation. The 
1.44 MB drive has a motor start time of one second so the 
default value for this field is set to 08h. 


INT 13h Diskette Service | 265 


Error Handling 


Introduction 


The CBIOS Diskette Service returns the completion status of each function 


via the AH register, the Carry Flag, Diskette Status (40:41h) and in Disk 
Controller Status (40:42h). 


Successful functions 
Successful functions return as follows: 
=» AH = 00h (No error) 
= Diskette Status (40:41h) = AH 
=» Carry Flag = O (cleared) 


Unsuccessful functions 


Unsuccessful functions return as follows: 
=» AH = xxh (Error code) 

= Diskette Status (40:41h) = AH 

= Carry Flag = 1 (set) 


Note: If the error was related to the diskette controller hardware, the con- 
tents of AH are also copied to Disk Controller Status (40:42h). 


continued 
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Error Handling, Continued 


Table: Error Codes 


The CBIOS Diskette Service error codes are listed in the table below. The 
Carry Flag is set if any of the following errors occur. 


Error code (in AH) Description 


a 
a eC a 
a 
cor 
a 
a 
ee 
ee 
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Rules for Using CBIOS and ABIOS Diskette Services 


Introduction 


Because they interface with two different operating systems, either the 
CBIOS or the ABIOS Diskette Services may put the diskette hardware into an 
unknown state. 


Diskette hardware is not updated 


The CBIOS does not inform the ABIOS of the diskette hardware’s state when 
control is passed from the CBIOS to the ABIOS. Conversely, the ABIOS does 
not update the CBIOS diskette service data areas when control is passed 
back to the CBIOS from the ABIOS. 


As a result, it is possible for one part of the PS/2 ROM BIOS to put the 
diskette hardware in a state that will not be recognized by the other. To 
avoid potential confusion, care must be taken to reset the diskette system 
each time the CBIOS diskette service is re-entered after any ABIOS service 
Call. 


Rules 


The matter is resolved by following the rules below: 


1 
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Do not invoke a CBIOS function if there is already an outstanding ABIOS 
function request. 


. Do not invoke an ABIOS function if there is already an outstanding CBIOS 


function request. 


. If the last function call was to ABIOS, invoke CBIOS function INT 13h, 


AH = 00h, Reset Diskette System, before invoking another CBIOS 
function. 


lf the last function call was to CBIOS, invoke ABIOS Diskette Service 
function 05h Reset Diskette System before invoking another ABIOS 
function. 


ABIOS Diskette Service function 05h, Reset Diskette System, must be the 
first ABIOS function called after ABIOS is initialized. 
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Function: AH = 00h Reset Diskette System 


Description 


The Reset Diskette System function resets both the diskette controller and 
the indicated diskette drive (the R/W arm is moved to cylinder 0). The 
diskette drive number (either 0 or 1) is indicated in DL. 


Using CBIOS Diskette Services and ABIOS Diskette Services 
= Do not invoke a CBIOS Diskette Service function if there already is an 
outstanding ABIOS function request. 


= Invoke INT 13h, AH = O0Oh, Reset Diskette System, before invoking any 
other CBIOS Diskette Service I/O function if the last Diskette Service 
access was via ABIOS. 


Switching between ABIOS and CBIOS 


Invoke this function after switching from CBIOS to ABIOS and before invoking 
any other ABIOS Diskette Service functions. For more information, see Rules 
for Using CBIOS and ABIOS Diskette Services in this chapter. 


Input/Output 
Input: AH = QOh 
DL = Drive number (0 or 1) 
Bit 7 = O for a diskette 
1 for a fixed disk 
Output: AH = OOh No error 
xxh Error (See “Error Codes” earlier in this chapter) 
= Diskette Status (40:41h) 
CF = Q No error 
= 1 Error 


Call this function when a problem occurs in attempting to access the diskette 
system, then retry the function that failed. Tne disk system will not react 
immediately. Instead, a reset flag forces the BIOS to recalibrate the disk 
drive’s read/write heads the next time they are used. The heads are pulled 
to track O in order to start the next I/O operation from track 0. 
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Function: AH = 01h Read Diskette Status | 


Description 


The CBIOS Diskette Service stores the error code associated with the last 
requested function in Diskette Status (40:41h). If the last function executed 
successfully, Diskette Status is set to OOh. If the last function was not suc- 
cessful, Diskette Status is set to the appropriate non-zero error code. 


The Read Diskette Status function reads the value contained in Diskette 
Status and returns it in the AH register. The Carry Flag (CF) is set if the 
value returned in AH is nonzero. Otherwise the Carry Flag is cleared. 


Input/Output 
Input: AH = Oth 
DL = Oor1 (drive number) 
Output: AH = 00h No error 
xxh Error (See “Error Codes” earlier in this chapter) 
= Diskette Status (40:41h) 
CF = 0ONo error 


1 Error 


The Diskette Status byte is saved after each read, write, verify or format 
disk function. This allows error handling or error reporting routines to be 
written which are entirely independent of disk operation routines. 
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Function: AH = 02h Read Diskette Sectors 


Description 
The Read Diskette Sectors function: 
» Reads the number of sectors specified in AL, 
=» From the drive specified in DL, 
= To the buffer specified in ES:BX 


The diskette drive head number is indicated in DH. Starting cylinder and 
sector numbers are indicated in CH and CL. 


This service is useful for bulk operations that require reading of individual 
or a whole trackful of sectors. For example, DISKCOPY in DOS uses this 


service. 
Input/Output 

Input: AH = Q2h 
AL = Number of sectors (1-18, depending on drive media type) 
CH = Track number (0-79, depending on drive media type) 
CL = Sector number (1-18, depending on drive media type) 
DH = Head number (0-1) 
DL = Drive number (0 or 1) 
ES:BX = Pointer to buffer 

Output: AL = Number of sectors read/written 
AH = O0Oh No error 


xxh Error (See “Error Codes” earlier in this chapter) 
= Diskette Status (40:41h) 
O No error 
= 1 Error 


CF 


Wait for device to reach proper speed 


With diskette drives, an error may be caused by the drive motor being off 
when the request is made. The CBIOS does not wait for the device to reach 
proper speed before trying to read. The calling program should reset the 
diskette drive (INT 13h function OOh) and retry three times to make sure that 
an error is real. 
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Function: AH = 03h Write Diskette Sectors 


Description 
The Write Diskette Sectors function: 
# Writes the number of sectors specified in AL, 
» From the drive specified in DL, | 
= To the buffer specified in ES:BX 
The diskette drive head number is indicated in DH. Starting cylinder and 


sector numbers are indicated in CH and CL. Disk sectors must be formatted 
before they can be written to. : 


Input/Output 
Input: AH = 03h 
AL = Number of sectors (1-18, depending on drive media type) 
CH = Track number (0-79, depending on drive media type) 
CL = Sector number (1-18, depending on drive media type) 
DH = Head number (0-1) 
DL = Drive number (0 or 1) 
ES:BX = Pointer to buffer 
Output: AL = Number of sectors read/written 
AH = OOh No error 
xxh Error (See “Error Codes” earlier in this chapter) 
= Diskette Status (40:41h) 
CF = QO No error 
= 1 Error 


Wait for device to reach proper speed 


With diskette drives, an error may be caused by the drive motor being off 
when the request is made. The CBIOS does not wait for the device to reach 
proper speed before trying to write. The calling program should reset the 
diskette drive (INT 13h function 00h) and retry three times to make sure that 
an error is real. | 
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Function: AH = 04h Verify Diskette Sectors 


Description 
The Verify Diskette Sectors function: 
» verifies the number of sectors specified in AL, 
= from the drive specified in DL, 
=» to the buffer specified in ES:BX. 
The diskette drive head number is indicated in DH. Starting cylinder and 


sector numbers are indicated in CH and CL. No data is transferred from the 
disk in this operation. Disk data is not compared to data in memory. 


_ The CBIOS Diskette Service verifies diskette sectors by determining if the 
sectors can be found, read, and pass the Cyclic Redundancy Check (CRC). 


Input/Output 

Input: AH = O4h. 
AL = Number of sectors (1-18, depending on drive media type) 
CH = _ Track number (0-79, depending on drive media type) 
CL = Sector number (1-18, depending on drive media type) 
DH = Head number (0-1) 
DL = Drive number (0 or 1) 

Output: AL = Number of sectors actually transferred 
AH = QOh No error 

nnh Error (See “Error Codes” earlier in this chapter) 
= Diskette Status (40:41h) 

CF = ONO error 


= 1 Error 
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Function: AH = 05h Format Diskette Track 


Description 


The Format Diskette Track function formats a single diskette track on the 
drive specified in DL. The number of sectors is specified in AL, the head 
number in DH, and the track number in CH. Each call to service 05 can be 
verified by following it with a call to service 04h. 


ES:BX points to a table defining the address fields for the track being 
formatted. 7 


Note: If the diskette drive in question supports more than one diskette 
format, the CBIOS user must call either Diskette Service function 
AH = 17h Set Diskette Type or AH = 18h Set Media Type for Format 
before calling this function. 


Input/Output 
Input: AH = Q5h 
AL = Number of sectors to be formatted (starts at one) 
DL = Drive number (0 or 1) 
DH = Head number (0 or 1) 
CH = Track number (starts at 0) 
ES:BX = Address field buffer 
Output: AH = QOh No error 
= 80h Specified diskette drive does not exist 
xxh Error (See “Error Codes” earlier in this chapter) 
= Diskette Status (40:41h) 
CF = Q No error 
= 1 Error 


continued 
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Function: AH = 05h Format Diskette Track, Continued 


Address Field Table 


The Address Field Table must contain one entry for each sector on the track 
to be formatted. Each entry consists of four bytes as defined in the table 
below. 


a 
stor numer 


Bytes/sector number, where: 
02h = 512 bytes/sector 


Example: Address Field Table 
For example, the address field to format track 3, head 0 of a 9 sector/track 
diskette with 512-—byte sectors, would be: 
db 03,00,01,02,03,00,02,02,03,00,03,02 
db 03,00,04,02,03,00,05,02,03,00,06,02 
db 03,00,07,02,03,00,08,02,03,00,09,02 


Copy protection 
Service 05h can be used for copy protection by: 
=" squeezing more sectors onto a track. 
= rearranging the order of the sectors. 
= leaving out a sector number. 
= specifying 1 or more sectors to be an unconventional size. 
» adding a sector with an unconventional address mask. 
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Functions: AH = 06h — 07h Reserved 


Function: AH = 08h Read Drive Parameters 


Description 


The Read Drive Parameters function returns the diskette parameters for the 
drive specified in DL. (Valid values are O and 1.) 


= The drive type stored in CMOS RAM determines the parameters returned. 
If the drive type is not stored in CMOS RAM, all registers return a value of 
zero, except DL which contains the number of diskette drives installed. 


» If the media type is Known, the maximum media capacity is returned in 
registers BL, CH, CL, and DH. A pointer to the diskette parameter table is 
returned in ES:DI. 


« If a diskette drive does not support the diskette change line, the parame- 
ters for a 360K, nine sector/track diskette in a 360K drive are pointed to 
by the value in ES:DI. The drive type returned in BL is zero. 


= If a change line is supported, the parameters for a 1.44 MB diskette in a 
1.44 MB drive are pointed to by ES:DI. The drive type returned in BL is 
zero. 


= If successful, the Carry Flag is cleared. Diskette Status (40:41h) is not 
modified unless the drive type input into DL is a value reserved for fixed 
disks only. (Valid values for fixed disk drives are 80h and 81h.) 


continued 
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Function: AH = 08h Read Drive Parameters, Continued 


Input/Output 
Input: AH 


Output: AX 


CF 


CH 
CL 
DH 


DL 
ES:DI 


O8h 

O or 1 (drive number) 
0 

0 

Bits 4-7 = 0 


Bits O-3 = Valid drive type value from CMOS 
Oth 5.25”, 360K, 40 track 

02h 5.25”, 1.2 MB, 80 track 

O3h = 3.5”, 720K, 80 track 

04h = 3.5”, 1.44 MB, 80 track 

O No error 

1 Illegal parameter 

Maximum usable track number 

Maximum usable sector number 

Maximum usable head number 

(always 1 if CMOS value valid) 

Number of diskette drives installed (0, 1, or 2) 
Pointer to diskette drive parameter table for 
the maximum media type supported on the 
specified drive 


Functions: AH = 09h - 14h Reserved 
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Function: AH = 15h Read Drive Type 


Description 
The Read Drive Type function returns information about the drive specified in 
the DL register. (Valid values are 0 and 1.) 


Unlike most other CBIOS Diskette Service functions, the value returned in the 
AH register by this function is not an Error Code. Instead, the value returned 
in AH corresponds to one of the four indicators described in the table below. 


No drive installed 


Diskette drive that cannot detect media change (360K, 
40-track diskette) 


02h Diskette drive that can detect media change (1.2 MB, 
80-track diskette) 


Input/Output 
Input: AH = 15h 
DL = _ Drive number (0 or 1) 
Output: AH = OOh Drive number is valid 


= Oth Diskette drive with no change line 
= Q2h Diskette drive with a change line 
= Q3h Fixed disk installed 

CF = OQ No error 

1 Invalid drive number 
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Function: AH = 16h Detect Media Change 


Description 


The Detect Media Change function determines if the drive door has been 
opened since the last time the change line was cleared. 


Use INT 13h function 15h first to determine whether the diskette drive 
hardware can sense when a diskette is changed. 

lf the drive number is not valid, the Carry Flag is set, AH is set to Oth, 
and control is returned to the caller. 


If the drive is not configured, AH and Diskette Status are set to 80h 
(time-out), CF is set, and control is returned to the caller. 


When this function returns with CF set, it does not necessarily mean that 
a diskette has been changed. It only means that the diskette drive door 
has been opened and closed since the last time the change line was 
cleared. 


If the change line is not supported, AH and Diskette Status are set to 06h 
(media change), CF is cleared, and control is returned to the caller. 


Input/Output 
Input: AH = 16h 


DL = Drive number (0 or 1) 


Output: AH = OQOh Diskette change line signal not active 


= Qth Invalid drive number 
= Q6h Either change line not supported or 
diskette change line signal is active 
= 80h Diskette drive not ready or no drive present 
= Diskette Status (40:41h) 
CF = ONO error 
= 1 Error 
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Function: AH = 17h Set Diskette Type 


Description 


The Set Diskette Type function sets the transfer rate for the specified drives 
using the diskette types passed in AL. 1.44 MB drives are not handled by 
this function. This function is provided for compatibility with DOS 3.0 or 3.1. 
Function 18h supersedes it for DOS 3.2 and up. If the diskette type in AL is 
invalid, AH and Diskette Status are set to 01h, CF is set, and control is 
returned to the caller. If the drive number is invalid, CF is set, AH and 
Diskette Status are set to 01h, and control is returned to the caller. 


The media transfer rates are set according to the drive type specified. For 
diskette types 2, 3, and 4, the change line determines if there is a diskette 
in the drive. If there is no diskette in the drive, AH and Diskette Status are 
set to 80h (time-out), CF is set, and control is returned to the caller. If a 
diskette is present, Diskette Status is set to O0Oh and the following values are 
set according to the diskette type in AL. 


0a | 800 Ks (07) 
250Kbe (100) [| No «|e 


Input/Output 


Input: AH = 17h 
AL = Oth 360K diskette in 360K drive 
= Q2h 360K diskette in 1.2 MB drive 
= 03h 1.2 MB diskette in 1.2 MB drive 
= 04h 720K diskette in 720K drive 
Output: AH = 00h No error 
= xxh Error (See “Error Codes” earlier in this chapter) 
= Diskette Status (40:41h) 
CF = ONo error 
= 1 Error 
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Function: AH = 18h Set Media Type for Format 


Description 


The Set Media Type for Format function sets the media type in preparation 
for a format command. 


= If the drive number is not valid, the Carry Flag (CF) is set and control is 
returned to the caller with both AH and Diskette Status (40:41h) equal to 


Oth. 


» If the drive number is valid, this function determines if the drive supports 
a change line. If the drive supports a change line, this function determines 
if there is a diskette in the drive. If there is no diskette, AH and Diskette 
Status are set to 80h (time-out), the Carry Flag (CF) is set, and control 
is returned to the caller. 

= If the drive type can’t be determined, AH and Diskette Status are set to 
OCh (unknown media), CF is set, and control is returned to the caller. 

» If there are no problems with the values returned by this function, a 
diskette table is chosen based on the data input to this function. ES:DI 
points to the chosen diskette parameter table, AH and Diskette Status are 
set to 00h, CF is cleared, and control is returned to the caller. 


Input/Output 


Input: AH 
| CH 
CL 

DL 


Output: ES:DI 
AH 


CF 


18h 

Maximum number of tracks 
Maximum sectors per track 
Drive number (0 or 1) 


Pointer to drive parameter table 

OOh track/sector combination is supported 

OCh Media unknown (CMOS not valid, drive not 
configured in CMOS, or not in diskette parameter table) 
80h No diskette in drive 


= Diskette Status (40:41h) 
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O No error 
1 Error 
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Functions: AH = 19h - FFh Reserved 


INT OEh Diskette Hardware Interrupt 


Introduction 


The CBIOS Diskette Interrupt Service Routine (ISR) services interrupts from 
the diskette controller. 


How CBIOS Diskette ISR is invoked 


The Diskette controller generates an INT OEh, the CBIOS Diskette ISR, to 
signal the completion of the last command issued by INT 13h. 


To maintain compatibility, the INT OEh entry point is located at address 
FQOO:EF57h. INT OEh resides at address 40h in the Interrupt Vector Table. 


CBIOS multitasking support 
Each time the CBIOS Diskette Service issues a diskette controller command, 
it also invokes INT 15h with AH = 90h Device Busy Loop. 


Calling INT 15h allows other tasks in the system to process while diskette |/O 
is in progress. However, this multitasking must be implemented by user- 
supplied programs executing in the microprocessor’s real address mode. 


INT OEh and multitasking return 


When the diskette controller completes a command, it issues an INT OEh 
interrupt and enables interrupts. 


INT OEh sets Bit 7 of the Diskette Drive Recalibrate Status byte (40:3Eh) and 
calls INT 15h with AH = 91h and AL = Oth Interrupt Complete. Then it sets 
Bit 7 of (40:3Eh) to signal the completion of the command. 


continued 
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INT OEh Diskette Hardware Interrupt, Continued 


I/O Port table 
INT OEh, Diskette ISR, references the following I/O ports: 


Read/Write 
1/O Address Status Description 


Diskette controller status register A, where: 


Bit 7 = 1 Interrupt pending 

Bit 6 = 0 Second drive installed 

Bit 5 = 1 Step 

Bit 4 = 0 Track 0 

Bit 3 = 1 Select head 1 

Bit 2 = 0 index 

Bit 1 = 0 Write protect 

Bit 0 = 1 Direction is from controller to diskette 


System RAM data area 


INT OEh, Diskette ISR, references the following system RAM data area 
locations: 


| tecation | tangth | Description 


Diskette drive recalibrate status, where: 


Bit 7 = 1 Diskette hardware interrupt has 
occurred 

Bit 6-4 = Not used 

Bits 3,2 = Reserved 

Bit 1 = Recalibrate drive 1 

Bit 0 = Recalibrate drive 0 


INT 13h Diskette Service 283 


1 


Chapter 17 
INT 13h Fixed Disk Service 


Overview 


Description 


The CBIOS Fixed Disk Service performs BlOS-level read, write, format, 
diagnostic, initialization and other operations for up to two fixed disk drives. 


How the service is invoked 
INT 13h invokes the CBIOS Fixed Disk Service. 


The INT 13h vector resides at the Interrupt Vector Table address 00:4Ch. 
The CBIOS initializes the INT 13h Fixed Disk Service vector to address 
FOOO:E3FEh, the IBM-compatible BIOS entry point. 


continued 
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Overview, Continued 


Summary of fixed disk service functions 


The CBIOS Fixed Disk Service contains several functions. Individual functions 
are selected via AH. The table below summarizes these functions. 


Description 


| oh | Reset Disk System 


Read Disk Status 


Read Disk Sectors 
03h Write Disk Sectors 


Oh 

on Very isk Sectors 
Pon Format Dink ovinser 
[08h | ead ove Parameters 
teh | rites rive Pararetere 
[enh | eat Long Disk Sectors 
[ere Long Dik Secters 
ncn sto vinden 
oon] Aternate Reset Frog Dek 
[och —lacnostion 1, Read Test Bufor 
[Fn ingestion 2, Write Test Butter 
tah ret for re Rea 
ee 
es 
ee 
a 
ee 
a 
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0Ch 

OFh 

1Ah | 
1Bh-FFh 
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Overview, Continued 


In this chapter 


This chapter focuses on the CBIOS Fixed Disk Service. The following topics 
are presented: 


Hardware Environment 

Fixed Disk Service |/O Ports 

System RAM Data 

CMOS RAM Data 

ROM BIOS Data 

Fixed Disk Service Error Handling 

Rules for Using CBIOS and ABIOS Fixed Disk Services 
Fixed Disk Service Functions 
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Hardware Environment 


Support for two fixed disk drives 


The CBIOS Fixed Disk Service will physically support up to two fixed disk 
drives. An ST412/506 interface fixed disk adapter or equivalent is assumed 
present. CBIOS uses information from the drive table which may include 


support for RLL and ESDI drives. ESDI drives generally require an option 
ROM. | 


How fixed disks are identified 


Each fixed disk must be identified to the system with a unique number. 


There are only two valid fixed disk identification numbers — 80h and 81h. 
The numbers must be assigned as per below: 


=» Fixed Disk Drive 0 = 80h 
« Fixed Disk Drive 1 = 81h 


Note: The fixed disk drive values 80h or 81h are required DL register 
inputs for many of the INT 13h fixed disk services. 


CBIOS diskette support 


When a fixed disk is installed, the CBIOS automatically redirects all INT 13h 
Diskette Service requests to INT 40h. This redirecting is transparent to end 


users, however. End users should continue to invoke INT 13h for both 
diskette and fixed disk services. 


For discussion of CBIOS Diskette Services, refer to Chapter 10. 
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Fixed Disk Service I/O Ports 


INT 13h, Fixed Disk Service, references the following I/O ports: 


. 


0020h 


0020 W 


INT 13h Fixed Disk Service 


Read/Write 
i/O Address Status Description 


DMA Extended function register where: 
Bits 7-4 = Progress command, where: 


00h I/O address register 

01h Reserved 

02h Memory address register write 
03h Memory address register read 
04h Transfer count register write 
05h Transfer count register read 
O6h Status register read 

07h Mode register 

O8h Arbus register 

09h Mask register set single bit 
OAh Mask register reset single bit 
OBh-OCh Reserved 

ODh Master clear 

OEh-OFh Reserved 


Bits 3-0 = 0 Reserved 


001Ah ca DMA Extended function execute register 


Interrupt request/in-service registers programmed 
by Operation Command Word 3 (OCW3): 


interrupt request register, where: 
Bits 7-0 = 0 No active request for the cor- 


responding interrupt line 


= 1 Active request for the correspond- 


ing interrupt line 


Interrupt in-service register, where: 
Bits 7-O = 0 The corresponding interrupt line is 


not currently being serviced 


= 1 The corresponding interrupt fine is 


currently being serviced 


Initialization Command Word 1 (ICW1) (Bit 4 is 
one), where: 


Bits 7-5 = 000 Only used in 80/85 mode 

= 1 Reserved 

= 0 Edge triggered mode 

= 1 Level triggered mode 

= 0 Successive interrupt vectors are 


separated by eight bytes 
= 1 Successive interrupt vectors are 
separated by four bytes 


Single mode - no ICW3 needed 
No ICW4 needed 
ICW4 needed 
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Fixed Disk Service I/O Ports, Continued 


| Read/Write 
I/O Address Status Description | 


0021h ICW2, ICW3, or ICW4 in sequential order after 
ICW1 written to Port 0020h 
ICW2, where: 
Bits 7-3 = Address lines AO-A3 of base vector 
address for interrupt controller 
Bits 2-0 = 000 Reserved 
ICW3, where: 
Bits 7-O= 0 Slave controller not attached to 
corresponding interrupt pin 
= 0 Slave controller attached to 
corresponding interrupt pin 
iCW4, where: 
Bits 7-5= 000 Reserved 
Bit 4 =0 No special fully-nested mode 
= 1 Special fully-nested mode 
Bits 3-2= 00 Nonbuffered mode 
= 01 Nonbuffered mode 
= 10 Buffered mode/slave 
11 Buffered mode/master 
Bit 1 0 Normal EO! 
1 Auto EOI 
Bit 0 =Q 80/85 mode 
= 1 8086/8088 mode 


Interrupt mask register (OCW1), where: 
| Bit 7 =O Enable parallel printer interrupt 

Bit 6 = Q Enable diskette interrupt 

Bit5 | =0 Enable fixed disk interrupt 

Bit 4 = 0 Enable serial interrupt 

Bit3 =O Reserved 

Bit2 =0 Enable video interrupt 

Bit 1 = 0 Enable keyboard/pointing device/RTC 
interrupt 

BitO =O Enable timer interrupt 


OCW? (Bit 4 is zero, Bit 3 is zero), where: 
Bits 7-5 = 000 Rotate in automatic EOI mode 


(clear) 
= 001 Non-specific EO! 
= 010 No operation 
11 Specific EOI 
00 Rotate in automatic EOI mode (set) 
01 Rotate on non-specific EOI 
command 
110 Set priority command 
111 Rotate on specific EO! command 


= 0 
= 1 
= 1 


Bit4 = 0 Reserved 
Bit 3 = 0 Reserved 
Bits 2-0 = Interrupt request to which the command 


applies 


continued | 
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Fixed Disk Service I/O Ports, Continued 


Read/Write 
1/O Address Status Description 


OCW3 (Bit 4 is zero, Bit 3 is one), where: 


Bit 7 = 0 Reserved 
Bits 6-5= 00No operation 
01 No operation 
10 Reset special mask 
11 Set special mask 
Reserved 
Reserved 


Bit 4 : 
0 No poll command 
1 
0 
0 


Bit 3 
Bit 2 


Bits 1-0 


Poll command 
ONo operation 
1No operation 
10 Read interrupt request register on 
next read at Port 0020h 
11 Read interrupt inservice register on 
next read at Port 0020h 


CMOS RAM address register port, where: 


Bit 7 = 1 NMI disable 
= 0 NM! enabled 
Bits 6-O= 0 CMOS address 


CMOS RAM data register port 


Extended CMOS RAM address register port, least | 
significant byte 


Extended CMOS RAM address register port, most 
significant byte 


Extended CMOS RAM data register port 


System control port A, where: 
Bit 7 = 1 Fixed disk activity light bit A is on 


Bit 6 
Bit 5 
Bit 4 
Bit 3 
Bit 2 
Bit 1 
Bit 0 


1 Fixed disk activity light bit B is on 
0 Reserved 

1 Watchdog time-out occurred 

1 Security lock latch is locked 

0 Reserved 

1 Alternate gate A20 active 

1 Alternate hot reset 


Programmable Interrupt Controller 2 mask, where: 


Bit 7 =0 Reserved 
Bit 6 0 Enable fixed disk interrupt 

Bit5 |= 0 Enable 80387 exception interrupt 
Bit 4 0 Enable mouse interrupt 

Bit 3 0 Reserved 

Bit 2 0 Reserved 

Bit 1 0 Enable redirect cascade 

Bit 0 0 Enable real time clock interrupt 


continued 
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Fixed Disk Service I/O Ports, Continued 


Read/Write 
1/O Address Status Deseription 


[exon [aw Fixed Disk Adapter Register (8 or 16 bit) 


Fixed Disk Adapter Control Register, where: 


Bit 7 =1 Reset 
Bit6 = 1 Reserved (except during reset) 
Bit5 =1 16-bit mode (must match bit 2) 
= 0 8-bit mode 
Bit 4-3 = 0 Reserved 
Bit2 =1 16-bit mode (must match bit 5) 
= 0 8-bit mode 
Bit 1 = 1 Enable interrupt through Programmable 


Interrupt Controller (hardware interrupt) 
= 0 Enable interrupt through Interrupt 
Status Register (port 324h) 
= 1 DMA mode 
= 0 PIO mode 


Bit 0 


Fixed Disk Adapter Status Register, where: 
Bit 7-6 = 0 Reserved 


Bit 5 = 1 16-bit mode 
= 0 8-bit mode 
Bit 4 =1 Data transfer requested by adapter 
Bit 3. =1 Direction is adapter to system 
= 0 Direction is system to adapter 
Bit2 =1 Busy 
Bit 1 = 1 Interrupt request (notification) 


Bit 0 


Fixed Disk Adapter Attention Register, where: 


Bit 7 =1 Command control block 
Bit6 = 1 Command specify block 
Bit5 = 1 Sense summary block 


= 1 Transfer in progress 


Bit 4 =1 Data transfer requested by system 
Bit3 =0 Reserve 
Bit 2 =0 Drive 0 select 
= 1 Drive 1 select 
Bit 1  =0 Reserved 


Bit 0 
Fixed Disk Adapter Interrupt Status Register 
where: 


Bit 7 =1 Termination error, bits 0-6 indicate 
what the error is 


1 Abort current command 


Bit6 = 1 Invalid command 
Bit 5 =1 Command reject 
Bit 4-3 = 0 Reserved 
Bit 2 =0 Drive 0 selected 
= 1 Drive 1 selected 
Bit 1 =1 Error recovery procedure invoked 
BitO = 1 Equipment check 
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System RAM Data 


Introduction 


The Fixed Disk Service makes use of System RAM Data located in the CBIOS 
Data area and in the CBIOS Extended Data area. 


The CBIOS Data area (absolute hex address 400-500) contains data defini- 
tions that are referred to by the CBIOS Fixed Disk Service. 


Location Description 


40:74h 1 Word Status from last fixed disk operation, where: 


00h =No error 

O1h = Invalid function request 

02h = Address mark not found 

03h = Write protect error 

04h = Sector not found 

05h = Reset failed 

07h = Drive parameter activity failed 
08h = DMA overrun on operation 

09h = Data boundary error 

OAh = Bad sector flag detected 

OBh = Bad track detected 

ODh = Invalid number of sectors on format 
OEh = Control data address mark detected 
OFh = DMA arbitration level out of range 
10h = Uncorrectable ECC or CRC error 
11h =ECC corrected data error 

20h = General controller failure 

40h = Seek operation failed 

80h = Time-out 

AAh = Drive not ready 

BBh = Undefined error occurred 

CCh = Write fault on selected drive 

EOh = Status error/error register is 0 
FFh = Sense operation failed 


40:8Fh | 1 Byte Diskette controller information where: 


Bit 7 = Reserved 

Bit 6 = 1 If drive determined for drive 1 
Bit 5 = 1 If drive is multirate 

Bit 4 = 1 If drive supports change line 
Bit 3 = Reserved 

Bit 2 = 1 If drive 0 is multirate 

Bit 0 = 1 If drive 0 supports change line 


1 Word Extended CBIOS data area segment | 


continued 


40:75h 
40:8Ch 


40:Eh 
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System RAM Data, Continued 


BIOS Extended Data Area 


The CBIOS Extended Data area is located in the top 1K of system RAM; the 
segment of the extended data area is defined in location 40:0Eh of the 
CBIOS Data area. The Fixed Disk Service uses three locations in the CBIOS 
Extended Data area. Those locations are defined in the table below: 


EDA:3Dh 16 Bytes Fixed disk parameter table for drive 0, where: 
Offset Size Description 
00h Word Max number of cylinders 
02h Byte Max. number of heads 
03h Word Reserved 
05h Word Starting write precompensa 
tion cylinder 
07h Byte Not used 
08h Byte Control byte 
09h Byte Reserved 
OAh Byte Reserved 
OBh Byte Reserved 
OCh Word Landing zone 
| OEh Byte Number of sectors/track 
OFh Byte Reserved 


EDA:4Dh 16 Bytes Fixed disk parameter table for drive 1, where: 
Offset Size Description 
00h Word Max number of cylinders 
02h Byte Max. number of heads 
03h Word Reserved 
05h Word Starting write precompensa- 
| tion cylinder 
07h Byte Reserved 
08h Byte Control byte | 
09h Byte Reserved 
OAh Byte Reserved 
OBh © Byte Reserved 
0Ch Word Landing zone 
OEh Byte Number of sectors/track 


Fixed Disk arbitration level and channel 
number, where: 


Bits 7-4 = Channel number 
Bits 3-0 = DMA arbitration level 


— 


Note: EDA = Extended Data Area 
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CMOS RAM Data 


Introduction 


The Fixed Disk Service makes use of data stored in conventional CMOS 
RAM, and for those MCA-based systems that include more than four expan- 
sion slots, in Extended CMOS RAM. 


Table of CMOS RAM data used 
The CMOS RAM data referenced by the Fixed Disk Service is listed below. 


CMOS RAM 
Offset (hex) Description 


a5 Diagnostic status, where: 
Bit 7 = 1 Real time clock lost power 
Bit 6 = 1 CMOS checksum is bad | 
Bit 5 = 1 Invalid configuration information at POST 
| tth | { | 1 Byte | Type of fixed disk drive 0 


a a ne POS 2 configuration ae for channel 0 


Bit 4 = 1 Memory size compare error at POST 
Bit 3 = 1 Fixed disk or adapter fails initialization 
Bit 2 = 1 CMOS time found invalid 

Bit 1 = 1 Adapters do not match configuration 
Bit 0 = 1 Time-—out in reading an adapter ID 


POS 3 configuration byte for channel 3 


continued 
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CMOS RAM Data, Continued 


Extended CMOS RAM data 


The CBIOS uses an additional 2K of CMOS RAM to store Programmable 
Option Select (POS) data for MCA-based systems that include more than 
four expansion slots. Fixed disk parameter data for fixed disks other than 
those listed in the ROM BIOS Fixed Disk Parameter Table is also stored in 
this extra CMOS RAM. 


Table of Extended CMOS data used 


The table below outlines the extended CMOS RAM data used by the Fixed 
Disk Service. 


| CMOS RAM 
Offset (hex) Description | 


0000h LSB of adapter ID for channel 0 
0001h MSB of adapter ID for channel 0 


1 Byte 


ovo [tae | POs? torcharnel oT 
—onean [Tare [1S of cater 1b for channel 
[even [1 avte | SB of adapter for channel 1 
026m [Tae [FOS Bor charm 
oem [1 8re | POSS terchamett 
oon [tere | POS? torcharnel? 
[coer | ——t avte |S of adaptor 1b for channel 
—eosan | 1 evte | MS® of adepter ID for chanel 
[—ewecn [tee | Pos@terchanne’s 


008Dh MSB of adapter ID for channel 4 


008Fh POS 2 for channel 4 | 


0090h POS 3 for channel 4 
OOAFh LSB of adapter ID for channel 5 
O0BOh MSB of adapter ID for channel 5 


continued 
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CMOS RAM Data, Continued 


Extended CMOS data definitions, cont’d 


| Description 


POS 2 for channel 5 
POS 3 for channel 5 
LSB of adapter ID for channel 6 


| 1 Byte POS 2 for channel 6 
1 Byte POS 3 for channel 6 


LSB of adapter ID for channel 7 


0176 - 0185h Fixed parameter table for drive 1 
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ROM BIOS Data 


Description 


The Fixed Disk Parameters Table defines the types of fixed disk drives that 
can be used. The address of the correct entry within the Fixed Disk Parame- 
ters Table is contained in the INT 41h vector for drive 0 and in the INT 46h 
vector for drive 1. To maintain compatibility, the Fixed Disk Parameters Table 
is based at hex FOQQ0QO:E401. 


Parameter table structure 


Each entry in the Fixed Disk Parameters Table occupies 16 bytes. 


The 16-byte entry structure is defined in the table below: 


ee 
a 


= 


Bit5  =1 Defect map present at max, 
cylinder + 1 

Bit 4 = 0 Reserved 

Bit 3 = 1 More than 8 heads 

Bits 2-O= 0 Reserved 


Bit 7,6 =1 Disable rewiee (either bit disables) 
Number of sectors per track 


continued 
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ROM BIOS Data, Continued 


Fixed disk parameter entries 


The CBIOS portion of the ROM BIOS defines only the first 32 entries in the 
Fixed Disk Table. Fixed disk type 15 is not used. Definitions for fixed disk 
types 1-32 are located in a 16-byte table starting at FOOO:E401h. 


Table of fixed disk definitions 


The defined entries into the Fixed Disk Parameters table are listed below. 
Wherever possible, the manufacturer name and model number associated 
with a given drive type are listed in the column, “Manufacturer.” 


Write Landing | Sectors/ | Defect 
Type Manufacturer Heads} Precomp Zone Track —s 


i penone a 


IBM 20 MB 17 
Seagate ST-225 
CDC Wren Il 
9415-5-25 
Miniscribe 8438F 
| 3 | 18M 30 MB | eis | 6 | 300 | 615 | 17 | No 
IBM 46 MB 


IBM 20 MB 
Miniscribe MS 8425 
Seagate ST4026 
Tandon TM 262 
Tandon TM 702AT 


IBM 30 MB 
Seagate ST-4038 
CDC Wren Il 
9415-5-38 
Tandon TM 703AT 


a 


Note: If a table entry contains OFFFFh for Write Precompensation, then there is no write 
precompensation for this disk. If the write precompensation is zero, then there is 
write precompensation for all cylinders. 


“N 
1) 


¥ 
= 
ied 
Rela 
p12 
od 


continued 
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ROM BIOS Data, Continued 


Table of fixed disk definitions, cont’d 


| we —[ [on i | 
Type Manufacturer Heads| Precomp| Zone Track Map 
C4 [ewawe | 73 [ 7 oreren[ 75s [a7 [Ne | 
<_] SSRN "Seen 
pie [emzoma fez ff 4 fo | es || No 
Se i Ee a 
Oc 
Cie [ew seme | 028 
p20 | ew some [788 

ca [ware | 733 
| 22 | weMsomB | 733 | 
Ps [wows soe | 
612 
Lee 
| 28 
| 29 
| 30 | 
zm 
Es 


| 306 
Temzome | ew | 
Tem «05a | 06 
View aosme | ore | 
Crew 10Ma | soe | 
Trew 20me | ent | 
Taw 42.8 we +| 8a 


IBM 42.5 MB 


lf a table entry contains OFFFFh for Write Precompensation, then there is no write 
precompensation for this disk. If the write precompensation is zero, then there is 
write precompensation for all cylinders. 


ed 
732 
[735 
| 336 
ce 
[40 
ro |e 
ee 
zs 
[340 
Le! 
[780 
ee 


Note: 
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Fixed Disk Service Error Handling 


Introduction 


Upon return from each function, the Fixed Disk Service indicates the result of 
the operation with a numeric error code. This error code is returned in AH 
and is stored in The Fixed Disk Status byte (40:74h). 


Error code and successful functions 
Successful functions return with 


= AH and Fixed Disk Status (40:74h) set to 00h (i.e. Error Code = OOh, 
no error) 


» Carry Flag (CF) cleared 


Error codes and unsuccessful functions 
Functions which have not executed successfully return with 
= Carry Flag set 
=" AH and Fixed Disk Status (40:74h) set to one of 23 possibie error codes 


continued 
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Fixed Disk Service Error Handling, Continued 


Table of error codes 
The table below lists the Fixed Disk Service Error Codes. 


a 
[om | tna uncon passed AH or inva parameter 
[can =| Across marcnot found 
0 sector rations 
tid Cewet ales 
[teh | OA overun on operaton 
te [ata boundary rer 
[een Bad ovinder detected 
00h | rvalitnarber of sectors on format 
eh [oni data aaaross mark detested 
a 
in 
a 
a 
sen 
a 
a 
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Rules for Using CBIOS and ABIOS Fixed Disk Services 


Introduction 


Because they interface with two different operating systems, either the 
CBIOS or the ABIOS Fixed Disk Services may put the fixed disk hardware into 
an unknown state. 


Fixed disk hardware is not updated 


The CBIOS does not inform the ABIOS of the fixed disk hardware’s state 
when control is passed from the CBIOS to the ABIOS. Conversely, the ABIOS 
does not update the CBIOS fixed disk service data areas when control is 
passed back to the CBIOS from the ABIOS. As a result, it is possible for one 
part of the PS/2 ROM BIOS to put the fixed disk hardware in a state that will 
not be recognized by the other. 


To avoid potential confusion, care must be taken to reset the fixed disk 
system each time the CBIOS Fixed Disk Service is re-entered after any 
ABIOS service call. 


Rules 


The matter is resolved by following the rules below: 


VW 


INT 13h Fixed Disk Service 


Do not invoke a CBIOS function if there is already an outstanding ABIOS 
function request. 


. Do not invoke an ABIOS function if there is already an outstanding CBIOS 


function request. 


. If the last function call was to ABIOS, invoke CBIOS function INT 13h, 


AH = ODh Alternate Reset Fixed Disk System before invoking another 
ABIOS function. 


. If the last function call was to CBIOS, invoke Fixed Disk Service function 


O5h Reset Fixed Disk System before invoking another ABIOS function. 


ABIOS Fixed Disk function 05h Reset Fixed Disk System must be the first 
ABIOS function called after ABIOS is initialized. 
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Function: AH = 00h Reset Diskette(s) and Fixed Disk 


Description 


The Reset Diskette(s) and Fixed Disk function resets both the diskette and 
the fixed disk controllers. It places both the diskette and the fixed disk sys- 
tems in a known state by reinitializing the fixed disk and diskette drive pa- 
rameters and by recalibrating the read/write heads positions of both devices. 


The fixed disk drive number (either 80h or 81h) is specified in DL. If suc- 
cessful, this function returns with AH set to OOh and Carry Flag cleared. 


Note: The diskette system is reset regardless of the drive number specified 
in DL. To reset the fixed disk controller only, use function AH = ODh. 


Input/Output 
Input: AH = OOh 
Output: AH = OOh No error 
= Nonzero, Fixed Disk Service Error Code 
= Fixed Disk Status (40:74h) 


O No error 
1 Error 


CF 


Error conditions 


If not successful, the Reset Diskette(s) and Fixed Disk function returns with a 
nonzero error code in AH. 


Differentiating diskette from fixed disk errors 


The status of the last Diskette Service operation is stored in Diskette Status 
(40:41h), and the status of the last Fixed Disk Service operation is stored in 
Fixed Disk Status (40:74h). 


= lf the error code returned in AH by this function pertains to the diskette 
system, then the value of Diskette Status will be equal to the value of AH. 


« If the error code in AH pertains to the fixed disk, then the value in Fixed 
Disk Status will be equal to the value in AH. 
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Function: AH = 01h Read Disk Status 


Description 


The Read Disk Status function returns Fixed Disk Status, the error code from 
the last operation, in the AL register. Before returning to the caller this 
function sets Fixed Disk Status and AH to zero and clears the Carry Flag. 


Input/Output 
Input: AH 
| DL 
Output: AH 
AL 
CF 


Error conditions 


Oth 

Drive number 
80h Fixed disk 1 
81h Fixed disk 2 


OOh 

Fixed Disk Status (40:74h) 
Error code for last operation 
O No error 

1 Error 


lf not successful, the Read Disk Status function returns with a nonzero Error 
Code in AH and the Carry Flag set. 


INT 13h Fixed Disk Service 305 


Function: AH = 02h Read Disk Sectors 


Description 


The Read Disk Sectors function reads the number of sectors specified in AL 
from the drive specified in DL to a buffer area defined by ES:BX. 


Fixed disk head number is indicated in DH. Starting cylinder and sector 
number are indicated in CH and CL as shown in the Input/Output section 


below. 


If successful, the Read Disk Sectors function returns with the Carry Flag 
cleared and AH = OOh. 


Note: The number of sectors specified in AL must not be zero or greater 
than 128. Numbers greater than 128 cause a transfer of greater than 
64K, and thus force a DMA boundary error. 


Input/Output 
Input: 


Output: 


306 


AH 


O2h 

Number of sectors to read 

Cylinder number (low 8 bits, zero—based) 
Cylinder/sector number, where: 

Bits 7-6 = cylinder number (high 2 oe 
Bits 5-O = sector number 

Head number (zero-—based) 

Drive number 

80h fixed disk 1 

81h fixed disk 2 


= Pointer to buffer 


OOh No error 
Nonzero, error code 


= Fixed disk status (40:74h) 


O No error 
1 Error 


continued 
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Function: AH = 02h Read Disk Sectors, Continued 


Error conditions 


If it is unsuccessful, the Read Disk Sectors function returns with the Carry 
Flag (CF) set and the appropriate Fixed Disk Service error code in both AH 
and in Fixed Disk Status (40:74h). 


For example, if an invalid number of sectors is input into AL, then the Read 
Disk Sectors function returns with the CF set and AH and Fixed Disk Status 
(40:74h) set to O9h, the Error Code that indicates a DMA boundary error 
has occurred. 


Note: Since the disk drive motor takes a certain amount of time to reach a 
working speed, a program should try this function three times when 
an error condition occurs. It should also use the reset function be- 
tween tries. 
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Function: AH = 03h Write Disk Sectors 


Description 


The Write Disk Sectors function writes the number of sectors specified in AL 
to the drive specified in DL from a buffer area defined by ES:BX. 


The fixed disk head number is indicated in DH. Starting cylinder and sector 
number are indicated in CH and CL as shown in “Input/Output” below. 


If successful, the Write Disk Sectors function returns with the Carry Flag 
cleared and AH = OOh. 


Note: The number of sectors specified in AL must not be zero or greater 
than 128. Numbers greater than 128 cause a transfer of greater than 
64K, and thus force a DMA boundary error. 


Input/Output 
Input! AH ~~ = O3h 

AL = Number of sectors to write 

CH = Cylinder number (low 8 bits, zero—based) 

CL = Cylinder/sector number, where: 
Bits 7-6 = cylinder number (high 2 bits) 
Bits 5-O = sector number 

DH = Head number (zero—based) 

DL = Drive number 


80h fixed disk 1 
81h fixed disk 2 
ES:BX = Disk transfer address 


Output: AH = Status of operation — Fixed Disk Status (40:74h) 
CF = Q No error 7 
= 1 Error 


Error conditions 


If unsuccessful, the Write Disk Sectors function returns with the Carry Flag 
(CF) set and the appropriate Fixed Disk Service error code in both AH and 
Fixed Disk Status (40:74h). For example, if an invalid number of sectors is 
input into AL, then the Read Disk Sectors function returns with the CF set 
and AH and Fixed Disk Status (40:74h) set to 09h, the Error Code that 
indicates a DMA boundary error has occurred. 
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Function: AH = 04h Verify Disk Sectors 


Description 


The Verify Disk Sectors function verifies the number of sectors specified in 
AL on the cylinder, head, and drive specified in CH, CL, and DH respec- 
tively. (See “Input/Output” below.) 


If successful, the Verify Disk Sectors function returns with the Carry Flag 
cleared and AH and Fixed Disk Status (40:74h) set to OOh. 


Note: This function does not compare data on disk with data in memory. It 
merely verifies that the specified sectors can be read and that the 
cyclical redundancy check (CRC) is correct. 


Input/Output 
Input: AH = O4h 

AL = Number of sectors to verify 

CH = Cylinder number (low 8 bits, zero—based) 

CL = Cylinder/sector number, where: 
Bits 7-6 = cylinder number (high 2 bits) 
Bits 5-O = sector number 

DH = Head number (zero—based) 

DL = Drive number 


80h fixed disk 1 
81h fixed disk 2 
Output: AH = OOh No error 
= nonzero, Fixed Disk Service Error Code 
= Fixed Disk Status (40:74h) 
CF = ONo error 
= 1 Error 


Error conditions 


lf unsuccessful, the Verify Disk Sectors function returns with the Carry Flag 
(CF) set and the appropriate Fixed Disk Service error code in both AH and 
Fixed Disk Status (40:74h). 


Refer to the Error Conditions heading in this chapter for a table of Fixed Disk 
Service Error Codes. 
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Function: AH = 05h Format Disk Cylinder 


Description 


The Format Cylinder function formats the cylinder specified in CH and CL 
using the head specified in DL. 


The caller must provide a table of address markers pointed to by ES:BX. 
There must be one two-byte table entry for each sector on the cylinder. 
Table entries must be formatted as shown below: 


Byte 1 = good/bad flag 
OOh is good 
80h is bad 

Byte 2 = sector number 


Input/Output 
Input: AH = O5h 

CH = Cylinder number (low 8 bits) 

CL = Cylinder/sector number, where: 
Bits 7-6 = cylinder number (high 2 bits, zero—based) 
Bits 5-0 = sector number 

DH = Head number (zero-based) 

DL = Drive number 


80h fixed disk 1 
81h fixed disk 2 
ES:BX = Pointer to table of 2 byte address markers 
Output: AH = OOh No error 
= nonzero, Fixed Disk Service Error Code 
= Fixed Disk Status (40:74h) 
CF = Q No error 
1 Error 


Error conditions 
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If unsuccessful, the Format Disk Cylinder function returns with the Carry Flag 
(CF) set and the appropriate Fixed Disk Service error code in both AH and in 
Fixed Disk Status (40:74h). For example, if a time-out error occurs during 
the execution of this function an error code of 80h is returned in both AH 
and Fixed Disk Status. 


Refer to “Error Conditions” in this chapter for a table of Fixed Disk Service 
Error Codes. 
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Functions: AH = 06h —- 07h Reserved 


Function: AH = 08h Read Drive Parameters 


Description 


The Read Drive Parameters function returns parameters associated with the 
fixed disk drive whose number is specified in DL. (Valid numbers are 80h 
and 81h.) 


For drive 80h, the Read Disk Parameters function references the fixed disk 
parameter table pointed to by the Interrupt 41h vector. For drive 81h, the 
function references the Interrupt 46h vector. 


lf successful, the Read Drive Parameters function returns with AL and Fixed 
Disk Status set to zero. Maximum cylinder number is returned in CH, maxi- 
mum sector number in CL, maximum head number in DH, and number of 
fixed disk drives contained in the system is returned in DL. 


Input/Output 


Input: AH = O8h 
DL = Drive number 
80h fixed disk 1 
81h fixed disk 2 


Output: AH = 07h If drive number in DL is invalid 
= QOh If operation is successful 


AL = OOh 
CF = ONo error 
= 1 Error 
CH = Maximum usable cylinder number (low 8 bits, zero—based) 


(OOh if AH = 07h) 


continued 
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Function: AH = 08h Read Drive Parameters, Continued 


Input/Output, cont’d 


Output: CL = Cylinder/sector number, where: 
(Bits 7-O = OOh if AH = 07h) 
Bits 7-6 = Maximum usable cylinder number (high 2 bits) 
Bits 5-0 = Maximum usable sector number 


DH = Maximum usable nead number 
(zero—based, OOh if AH = 07h) 
DL = Number of drives (zero—based, OOh if AH = 07h) 


Error conditions 


If the drive number specified in DL is not valid, the Read Drive Parameters 
function returns with AH and Fixed Disk Status (40:74h) set to 07h to indi- 
cate that the drive parameter activity failed. AL, CX, and DX are set to 
zero, the Carry Flag is set, and control is returned to the caller. 
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Function: AH = 09h Initialize Drive Parameters 


Description 


The Initialize Drive Parameters function initializes the controller associated 
with the fixed disk drive whose number is specified in DL. (Valid values are 
80h and 81h.) 


For drive 80h, the Initialize Drive Parameters function references the fixed 
disk parameter table pointed to by the Interrupt 41h vector. For drive 81h, 
the function references the Interrupt 46h vector. 


lf successful, the Initialize Drive Parameters function returns with AH and 
Fixed Disk Status (40:74h) set and the Carry Flag cleared. 


Input/Output 


Input: AH = OSh 
DL = Drive number 
80h fixed disk 1 
81h fixed disk 2 


Output: AH = OOh No error 
= Q7h Operation has failed 
= Fixed Disk Status (40:74h) 
CF = OQ No error 
= 1 Error 


Error conditions 


If unsuccessful, the Initialize Drive Parameters function returns with AH and 
Fixed Disk Status (40:74h) equal to 07h. This indicates that drive parameter 
activity has failed. 


Note: The Initialize Drive Parameters function generates only two valid 
return codes: 


AH 
AH 


Fixed Disk Status = 00h = Function successful 
Fixed Disk Status = 07h = Function unsuccessful, 
drive parameter activity has failed. 
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Function: AH = 0Ah Read Long Disk Sectors 


Description 


The Read Long Disk Sectors function reads one sector from the location on 
the fixed disk specified in DL. This function also reads the two words of Error 
Correction Code (ECC) associated with that sector. Cylinder number, sector 
number, and head number are specified in CH, CL, and DH, respectively 
(see “Input/Output,” below). 


If successful, the Read Long Disk Sectors function returns with the Carry 
Flag cleared and AH and Fixed Disk Status (40:74h) equal to zero. 


Notes: This function is normally reserved for diagnostics and should not be 
used without good reason. 


Input/Output 
Input: AH = QAh 
AL = Oth (must always be 1) 
CH = Cylinder number (low 8 bits, zero—based) 


CL = Cylinder/sector number, where: 
Bits 7-6 = cylinder number (high 2 bits) 
Bits 5-O = sector number 
DH = Head number (zero—based) 
DL = Drive number 
80h fixed disk 1 
81h fixed disk 2 
ES:BX = Disk transfer address 
Output: AH = = 00h No error 
| = Nonzero, (Fixed Disk Service Error Code) 
= Fixed Disk Status (40:74h) 
CF = Q No error 
= 1 Error 


continued 
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Function: AH = 0Ah Read Long Disk Sectors, Continued 


Error conditions 


If unsuccessful, the Read Long Disk Sectors function returns with the Carry 
Flag (CF) set and the appropriate Fixed Disk Service error code in both AH 
and in Fixed Disk Status (40:74h). 


For example, if the number of sectors in AL is not equal to 01h, then the 
Read Long Sector function returns with AH and Fixed Disk Status (40:74h) 
equal to O1h (the invalid parameter error code) and the Carry Flag set. 


Refer to the Error Conditions heading in this chapter for a table of Fixed Disk 
Service Error Codes. 


Function: AH = OBh Write Long Disk Sectors 


Description 


The Write Long Disk Sectors function writes one sector to the location on the 
fixed disk specified in DL from the buffer pointed to by ES:BX. The function 
also writes the two words of Error Correction Code (ECC) associated with 
the specified sector. 


Cylinder number, sector number, and head number are specified in CH, CL, 
and DH, respectively (see Input/Output below). 


If successful, the Write Long Sectors function returns with the Carry Flag 
cleared and AH and Fixed Disk Status (40:74h) equal to zero. 


Additional information 


« The caller must indicate the number of long sectors to read in AL. Since 
the Read Long Disk Sectors function is limited to one sector, any AL value 
other than O1h results in an invalid parameter error condition. 

# Along with function AH = OAh, this function is normally reserved for diag- 
nostics and should not be used without good reason. 


continued 
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Function: AH = OBh Write Long Disk Sectors, Continued 


Input/Output 
Input: AH 


Output: AH 


CF 


Error conditions 


OBh 

Oih (must always be 1) 

Cylinder number (low 8 bits, zero—based) 
Cylinder/sector number, where: 

Bits 7-6 = cylinder number (high 2 bits) 
Bits 5-O = sector number 

Head number (zero—based) 

Drive number 

80h fixed disk 1 

81h fixed disk 2 


Disk transfer address 


OOh No error 
nonzero, (Fixed Disk Service Error Code) 


= Fixed Disk Status (40:74h) 


O No error 
1 Error 


lf unsuccessful, the Write Long Disk Sectors function returns to the caller 
with the Carry Flag (CF) set and the appropriate Fixed Disk Service error 
code in both AH and in Fixed Disk Status (40:74h). 


For example, if the number of sectors in AL is not equal to Oth, then the 
Read Long Sector function returns with AH and Fixed Disk Status (40:74h) 
equal to 01h (the invalid parameter error code) and the Carry Flag set. 


Refer to the Error Conditions heading in this chapter for a table of Fixed Disk 
Service Error Codes. 
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Function: AH = 0Ch Seek to Cylinder 


Description 


The Seek to Cylinder function positions the disk read/write head over the 
cylinder specified in CH and CL (see Input/Output below). The fixed disk 
drive number must be specified in DL. 


If successful, the Seek to Cylinder function returns with the Carry Flag 
cleared and AH and Fixed Disk Status (40:74h) equal to zero. 


Note: The Read Disk Sectors, Write Disk Sectors, Read Long Disk Sectors 
and Write Long Disk Sectors functions have a seek operation implicitly 
built into them and do not require a prior call of this function. 


Input/Output 
Input: AH = OCh 

CH = Cylinder number (low 8 bits, zero—based) 

CL = Cylinder/sector number, where: 
Bits 7-6 = cylinder number (high 2 bits) 
Bits 5-0 = sector number 

DH = Head number (zero—based) 

DL = Drive number 


80h fixed disk 1 
81h fixed disk 2 


Output: AH = OOh No error 
= Nonzero, (Fixed Disk Service Error Code) 
= Fixed Disk Status (40:74h) 
CF = QNo error 
1 Error 


Error conditions 


If unsuccessful, the Seek to Cylinder function returns to the caller with the 
Carry Flag (CF) set and the appropriate Fixed Disk Service error code in 
both AH and in Fixed Disk Status (40:74h). 


Refer to “Error Conditions” in this chapter for a table of Fixed Disk Service 
Error Codes. 
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Function: AH = ODh Alternate Reset Fixed Disk 


Description 


The Alternate Reset Fixed Disk is identical to the Reset Diskette(s) and Fixed 
Disk function (see AH = 00h) except that the diskette system is not reset. 


The caller must specify the fixed disk drive to reset in DL. The Alternate 
Reset Fixed Disk function reinitializes the fixed disk controller and places the 
specified fixed disk drive in a known state by resetting the fixed disk parame- 
ters and by recalibrating the read/write head positions. 


If successful, the Alternate Reset Fixed Disk function returns with the Carry 
Flag cleared and AH and Fixed Disk Status (40:74h) equal to zero. 


Input/Output 


Input: AH = ODh 
DL = Drive number 
80h fixed disk 1 
81h fixed disk 2 
Output: AH = OOh No error : 
= Nonzero, (Fixed Disk Service Error Code) 
= Fixed Disk Status (40:74h) 
CF = OQNo error 
1 Error 


A special case 


The ABIOS does not inform the CBIOS of the fixed disk hardware’s state 
when control is passed from the ABIOS to the CBIOS. As a result, it is 
possible for the ABIOS to put the fixed disk hardware into a state not recog- 
nized by the CBIOS. 


To avoid confusion, then, care must be taken to reset the fixed disk system 
each time the CBIOS Fixed Disk Service is re-entered after any ABIOS call. 
The following rules apply: 


1. Do not invoke a CBIOS function if there is already an outstanding ABIOS 
function request. 


2. If the last function call was to ABIOS, invoke CBIOS Fixed Disk Service 
function AH = ODh Alternate Fixed Disk Reset. 


continued 
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Function: AH = ODh Alternate Reset Fixed Disk, Continued 


Reference 


For more information on the relationship between the CBIOS and ABIOS fixed 
disk services, turn to the heading “Rules for Using CBIOS and ABIOS Fixed 
Disk Services” in this chapter. 


Error conditions 


If it is not successful, the Alternate Reset Disk function returns to the caller 
with the Carry Flag (CF) set and the appropriate Fixed Disk Service error 
code in both AH and in Fixed Disk Status (40:74h). 


Refer to the Error Conditions heading in this chapter for a table of Fixed Disk 
Service Error Codes. 
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Function: AH = 0Eh Diagnostics 1: Read Test Buffer 


Description 


The Diagnostics 1, Read Test Buffer, function reads a test buffer from the 
fixed disk adapter into the diagnostics buffer specified in ES:BX. Data is not 
read from the actual physical disk drive. 


If successful, the Diagnostics 1 function returns with the Carry Flag (CF) 
cleared and AH and Fixed Disk Status (40:74h) set to zero. 


Input/Output 


Input: AH = OEh Diagnostics 1, read test buffer 
DL = Drive number 
80h fixed disk 1 
81h fixed disk 2 
ES:BX = Pointer to diagnostic buffer 
Output: AH = 00h No error 
= Nonzero, (Fixed Disk Service Error Code) 
= Fixed Disk Status (40:74h) 
CF = Q No error 
= 1 Error 


Error conditions 


If it is not successful, the Diagnostics 1 function returns to the caller with the 
Carry Flag (CF) set and the appropriate Fixed Disk Service error code in 
both AH and in Fixed Disk Status (40:74h). 


Refer to the Error Conditions heading in this chapter for a table of Fixed Disk 
service Error Codes. 
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Function: AH = OFh Diagnostics 2: Write Test Buffer 


Description 


The Diagnostics 2, Write Test Buffer, function writes a test buffer to the 
adapter from the diagnostics buffer specified in ES:BX. Data is not written to 
the actual physical disk drive. 


If successful, the Diagnostics 2 function returns with the Carry Flag (CF) 
cleared and AH and Fixed Disk Status (40:74h) set to zero. 


Input/Output 


Input: AH = OFh Diagnostics 2, write test buffer 
DL = Drive number 
80h fixed disk 1 
81h fixed disk 2 
ES:BX = Pointer to diagnostic buffer 
Output: AH = QOh No error 
= Nonzero, (Fixed Disk Service Error Code) 
= Fixed Disk Status (40:74h) 
CF = 0 No error 
1 Error 


Error conditions 


If it is not successful, the Diagnostics 2 function returns to the caller with the 
Carry Flag (CF) set and the appropriate Fixed Disk Service error code in 
both AH and in Fixed Disk Status (40:74h). 


Refer to the Error Conditions heading in this chapter for a table of Fixed Disk 
Service Error Codes. 
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Function: AH = 10h Test for Drive Ready 


Description 


The Test for Drive Ready function determines if the drive specified in DL is 
ready and can process a command. 


If successful, the Test for Drive Ready function returns to the caller with the 
Carry Flag (CF) cleared and AH and Fixed Disk Status (40:74h) set to zero. 


Input/Output 
Input: AH 
DL 
Output: AH 
CF 


Error conditions 


10h 

Drive number 
80h fixed disk 1 
81h fixed disk 2 


OOh No error 

Nonzero, (Fixed Disk Service Error Code) 
Fixed Disk Status (40:74h) 

O No error 

1 Error 


If it is not successful, the Test for Drive Ready function returns to the caller 
with the Carry Flag (CF) set and the appropriate Fixed Disk Service error 
code in both AH and in Fixed Disk Status (40:74h). 


Refer to the Error Conditions heading in this chapter for a table of Fixed Disk 
Service Error Codes. 
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Function: AH = 11h Recalibrate Drive 


Description 


The Recalibrate Drive function repositions head O over cylinder 0 of the drive 


specified in DL. 


If successful, the Recalibrate Drive function returns with the Carry Flag (CF) 
cleared and AH and Fixed Disk Status (40:74h) set to zero. 


Input/Output 
Input: AH 
DL 
Output: AH 
CF 


Error conditions 


11h 

Drive number 
80h fixed disk 1 
81h fixed disk 2 


OOh No error 

Nonzero, (Fixed Disk Service Error Code) 
Fixed Disk Status (40:74h) 

O No error 

1 Error 


If it is not successful, the Recalibrate Drive function returns to the caller with 
the Carry Flag (CF) set and the appropriate Fixed Disk Service error code in 
both AH and in Fixed Disk Status (40:74h). 


Refer to the Error Conditions heading in this chapter for a table of Fixed Disk 
Service Error Codes. 


Function: AH = 12h - 14h Reserved 
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Function: AH = 15h Read Disk Type 


Description 


The Read Disk Type function returns the number of 512-byte blocks on the 
fixed disk if the drive specified in DL is valid. (Valid values are 80h and 8th.) 


If successful, the high word 512-byte block amount is returned in CX, and 
the low word amount is returned in DX. Fixed Disk Status (40:74h) and the 
Carry Flag (CF) are set to zero, and control is returned to the caller. 


Input/Output 


AH 


Input: AH = 15h 
DL = Drive number 
80h fixed disk 1 
8ih fixed disk 2 


Output: AH = O0QOh No drive installed 
= 03h Fixed disk was accessed 
= Nonzero (Fixed Disk Service Error Code) 
= Fixed Disk Status (40:74h) 
CF = ONO error 
1 Error 


reports drive number validity 


For drive 80h, the Read Disk Type function references the fixed disk parame- 
ter table pointed to by the Interrupt 41h vector. For drive 81h, the function 
references the Interrupt 46h vector. 


Unlike most other Fixed Disk Service functions, in the Read Disk Type func- 
tion the value stored in AH is not equal to the value stored in Fixed Disk 
Status (40:74h). Instead, AH reports whether or not the drive number input 
into DL is valid (i.e., whether or not the drive is installed). 


Error conditions 
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If the drive number specified in DL is not valid, the Read Disk Type function 
sets AH, AL, CX, DX, the Carry Flag (CF), and Fixed Disk Status (40:74h) 
to zero, and returns control to the caller. 


CBIOS for IBM PS/2 Computers and Compatibles 


Functions: AH = 06h —- 07h Reserved 


Function: AH = 19h Park Heads 


Description 


The Park Heads function positions the heads of the fixed disk read/write 
mechanism on the landing zone of the disk. 


For drive 80h, the landing zone cylinder is specified in the fixed disk parame- 
ter table pointed to by the Interrupt 41h vector. For drive 81h, the landing 
zone cylinder is specified in the parameter table pointed to by the Interrupt 


46h vector. 
Input/Output 
Input: AH = 19h 
DL = Drive number 


80h fixed disk 1 
81h fixed disk 2 


Output: AH = OOh No error 
= Nonzero (Fixed Disk Service Error Code) 
= Fixed Disk Status (40:74h) 
CF = Q No error 
1 Error 


Error conditions 


If it is not successful, the Test for Drive Ready function returns to the caller 
with the Carry Flag (CF) set and the appropriate Fixed Disk Service error 
code in both AH and in Fixed Disk Status (40:74h). 


Refer to the Error Conditions heading in this chapter for a table of Fixed Disk 
Service Error Codes. 
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Function: AH = 1Ah Format ESDI Drive 


Description 


The Format ESDI Drive function initializes the disk sector and track address 
fields on a drive attached to ESDI Fixed Disk Drive Adapter A. Normally, ESDI 
drives require an option ROM. 


This function is a low level format that prepares the fixed disk for physical 
read/write operations at the sector level. The disk then has to be partitioned 
with the FDISK command and the FORMAT command used to give the disk a 
high level format and install a file system on it. 


This function is not implemented in every BIOS. The Phoenix CBIOS supports 
ESDI. low-level format through the Phoenix Reference Diskette. 


Warning 


The formatting process will destroy all information on the fixed disk. 


i Vi il 


1Ah | 

Relative block address (RBA) defect table block count 
O No RBA table 

O RBA table is used 

Format modifier bits, where 


Bit O = ignore primary defect map 

Bit 1 = ignore secondary defect map 
Bit 2 = update secondary defect map 
Bit 3 = do extended surface analysis 


Bit 4 = generate periodic interrupt 
Bits 5-7 = reserved (= 0) 

Drive number 

80h fixed disk 1 

81h fixed disk 2 

Pointer to RBA table 


OOh No error 
Nonzero (Fixed Disk Service Error Code) 


= Fixed Disk Status (40:74h) 


O No error 
1 Error 


continued 


Input/Output 
Input: AH 
AL 
CL 
DL 
Output: AH 
CF 
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Function: AH = 1Ah Format ESDI Drive, Continued 


Error conditions 


If it is not successful, the Format ESDI Drive function returns to the caller 
with the Carry Flag (CF) set and the appropriate Fixed Disk Service error 
code in both AH and in Fixed Disk Status (40:74h). 


Refer to the Error Conditions heading in this chapter for a table of Fixed Disk 
Service Error Codes. 


Additional information 


» When bit 4 of CL is set, INT 15h function AH = OFh, subfunction AL = 
phase code is called after each cylinder is formatted or analyzed. The 
phase codes are: 

O = reserved 
1 = surface analysis 
2 = formatting 
Refer to INT 15h function AH = OFh for further information. 

» When bit 2 of CL is set, the secondary defect map for the drive is up- 
dated so it reflects any errors found during surface analysis. The secon- 
Gary defect map is replaced when both bit 1 and bit 2 are replaced. 

= To do an extended surface analysis, first format the disk by calling this 
function with bit 3 cleared, then do the analysis by calling the function with 
bit 3 set. 


= For other types of fixed disk adapters, this function is reserved. 
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Chapter 12 


INT 14h Serial Communications 
Service 


Overview 


Description 


The CBIOS Serial Communications Service performs RS-232-C character |/O 
on iBM-compatibie seriai port adapters. 


How the Serial Communications Service is invoked 
Software INT 14h invokes the CBIOS Serial Communications Service. 


The INT 14h vector resides at address 00:50h in the Interrupt Vector Table. 
The CBIOS initializes the INT 14h vector to address F000:E739h, the IBM- 
compatible entry point. 


continued 
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Overview, Continued 


Summary of Serial Communications functions 


The CBIOS Serial Communications Service contains six functions. Individual 
functions are selected via the AH register. 


The table below summarizes the Serial Communications Service functions. 


| ooh sd Initialize Serial Communications Port | 


In this chapter 


This chapter focuses on the CBIOS Serial Communications Service. The fol- 
lowing topics are discussed: 

=» Hardware Environment 

» Serial Communications I/O Ports 

= System RAM Data 

= ROM BIOS Data 

» Error Conditions 

#® Serial Communications Functions 
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Hardware Environment 


NS 16550 Serial Communications Controller 


The CBIOS Serial Communications Service assumes a National 
Semiconductor NS 16550 serial communications controller (or compatible) is 
in place. The NS 16550 contains a programmable baud rate generator that 
supports baud rates from 50 baud to 19,200 baud. The NS 16550 also sup- 
ports 5-, 6-, 7-, and 8-bit characters with 1-, 1.5-, or 2-stop bits operat- 
ing in even, odd, and no parity modes. 


Serial port addresses/interrupt levels 


The following table lists the serial port base addresses. 


Serial Port Number Base Address Interrupt Level 
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Serial Communications I/O Ports 


Read/Write 
1/O Address Status Description 
03F8h | WwW Serial 1, transmitter holding register, where: 
Bits 7-0 = Data bits 7-0, respectively, 
when Divisor Latch Access Bit 
(DLAB) = 0 
03F8h a Serial 1, receiver buffer register, where: 


Bits 7-0 = Data bits 7-0, respectively, 


Bits 7-0 = Bits 15-8 of divisor, when 
DLAB = 1 


Serial 1 Interrupt ID Register, where: 


Bits 7-3 = 0 Reserved 
Bits 2-1 = 00b Modem Status Interrupt 
01b Transmitter Holding Register 
Empty Interrupt 
10b Received Data Available 
Register Interrupt | 
11b Receiver Line Status Interrupt 
= 0 Interrupt Pending 


when DLAB = 0 
Serial 1, divisor latch, low byte, where: 
Bits 7-0 = Bits 7-0 of divisor, when DLAB = 1 
O3FSh 
03F9h 


Serial 1, divisor latch, high byte, where: 
O3FAh 


Bit 0 


Serial 1 Interrupt ID Register, where: 


Bits 7-3 = 0 Reserved 
Bits 2-1 = 00b Modem Status Interrupt 
Oib Transmitter Holding Register 
Empty Interrupt 
10b Received Data Available 
Register Interrupt 
11b Receiver Line Status Interrupt 
Bit 0 = 0 Interrupt Pending 


continued 
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Serial Communications 1|/O Ports, Continued 


Read/Write 
1/O Address Status Description 


O3FAh W Serial 1, FIFO Control Register, where: 
Bits 7-6 = Receiver FIFO register trigger 


- 
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00b = 1 byte 
O1b = 4 bytes 
10b = 8 bytes 


11b = 14 bytes 
Bits 5-3 = 0 Reserved 
Bit 2 = Transmitter FIFO register reset 
1 = transmit FIFO register cleared, 
counter cleared, bit is self- 
clearing 
Bit 1 = Receiver FIFO register reset 
1 = receiver FIFO register cleared, 
counter cleared, bit is self- 
clearing 
Bit O = FIFO enable 
1 = receiver and transmitter FIFOs 
enabled, must be 1 to program 
FIFO registers 
0 = clears receive and transmit 
FIFO registers, enters 
character mode 


Serial 1, Line Control Register, where: 


Bit 7 = 0 Receiver Buffer, Transmitter 
Holding, or Interrupt Enable 
Registers Access 


b 6 Bit Word Length 
Ob 7 Bit Word Length 
11b 8 Bit Word Length 


Serial 1, Mode Control Register, where: 
Bits 7-5 = 0 Reserved 


= 1 Divisor Latch Access 
Bit 6 = 1 Set Break Enabled 
Bit 5 = Stick Parity 
Bit 4 = Even Parity Select 
Bit 3 = Parity Enable 
Bit 2 = 01 Stop Bit 

= 10 Stop Bits 
Bits 1-0 = oe 5 Bit Word Length 

1 


= 1 Force OUT1 Active 
Bit 1 = 1 Force Request-To-Send Active 
Bit 0 = 1 flies Data-Terminal-Ready 
ctive 


continued 


Serial Communications I/O Ports, Continued 


Read/Write 
0 Address Status Description 


Serial 1, Line Status Register, where: 


Bit 7 = 0 Reserved 

Bit 6 = 1 Transmitter Shift and Holding 
Registers Empty 

1 Transmitter Holding Register Empty 

1 Break Interrupt 

1 Framing Error 

Trailing Edge Ring Indicator 


Overrun Error 
Bit 0 = 1 Data Ready 


Serial 1, Modem Status Register, where: 


Bit 7 = 1 Data Carrier Detect 

Bit 6 = 1 Ring Indicator 

1 Data Set Ready 

1 Clear To Send 

1 Delta Data Carrier Detect 
1 Trailing Edge Ring Indicator 


1 Delta Data Set Ready 
Bit 0 = 1 Delta Clear To Send 


Serial 1, Scratch Register 


Serial 2, transmitter holding register, where: 
Bits 7-0 = Data bits 7-0, respectively, 
when DLAB = 0 
a Serial 2, receiver buffer register, where: 


Bits 7-0 = Data bits 7-0, respectively, 
when DLAB = 0 


Serial 2, divisor latch, low byte, where: 
Bits 7-0 = Bits 7-0 of divisor, when DLAB = 1 


Serial 2, divisor latch, high byte, where: 
Bits 7-0 = Bits 15-8 of divisor, when DLAB = 1 


Serial 2, interrupt enable register, where: 


Bits 7-4 = 0 Reserved 

Bit 3 = 1 Modem-status interrupt enable 

Bit 2 = 1 Receiver-line-status interrupt 
enable 

Bit 1 = 1 Transmitter-holding-register 
empty interrupt enable 

Bit 0 = 1 Received-data-available interrupt 
enable when DLAB = 0 


continued 
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Serial Communications |/O Ports, Continued 


Read/Write 
1/O Address Status Description 


O2FAh Serial 2, interrupt identification register, where: 
Bits 7-3 = 0 Reserved 
Bits 2-1 = 00b Modem status interrupt 
= 01b Transmitter holding register 
empty interrupt 
= 10b Received data available register 
interrupt 
= 11b Receiver line status interrupt 
Bit 0 = 0 Interrupt pending 


O2FAh Serial 2, FIFO control register, where: 


Bits 7-6 = Receiver FIFO register trigger 


- 
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00b = 1 byte 
O1b = 4 bytes 
10b = 8 bytes 


11b = 14 bytes 
Bits 5-3 = 0 Reserved 
Bit 2 = Transmitter FIFO register reset 
1 = transmit FIFO register cleared, 
counter cleared, bit is self- 
clearing 
Bit 1 = Receiver FIFO register reset 
1 = receiver FIFO register cleared, 
counter cleared, bit is self- 
clearing 
Bit 0 = FIFO enable 
1 = receiver and transmitter FIFOs 
enabled, must be 1 to program 
FIFO registers 
0 = clears receiver and transmits 
FIFO registers, enters character 
mode 


Serial 2, line control register, where: 


Bit 7 = 1 Divisor latch access 
= 0 Receiver buffer, transmitter 
holding, or interrupt enable 
registers access 


Bit 6 = 1 Set break enable 
Bit 5 = Stick parity 

Bit 4 = Even parity select 
Bit 3 = Parity enable 

Bit 2 = Number of stop bits 


Bits 1-0 = 00b Word length is 5 bits 
01b Word length is 6 bits 
10b Word length is 7 bits 
11b Word length is 8 bits 


Serial 2, modem control register, where: 
Bits 7-5 = 0 Reserved 


Bit 4 = 1 Loopback mode 

Bit 3 = 1 Enable OUT2 interrupt 

Bit 2 = 1 Force OUT1 active 

Bit 1 = 1 Force request-to-send active 

Bit 0 = 1 Force data-terminal-ready active 


continued 


Serial Communications I/O Ports, Continued 


Read/Write 
1/0 Address Status Description 


Serial 2, line status 7eaister: where: 


Bit 7 = 0 Reserved 
Bit 6 = 1 Transmitter shift and holding 


; = 
: Le 


Bit 4 = 1 Clear to send 

Bit 3 = 1 Delta to carrier detect 

Bit 2 = 1 Trailing edge ring indicator 
Bit 1 = 1 Delta data set ready 

Bit 0 = 1 Delta clear to send 


O2FFh | RW Serial 2, scratch register | 


Bit 0 = 1 Data ready 


Serial 2, modem status register, where: 
Bit 7 = 1 Data carrier detect 

Bit 6 = 1 Ring indicator 

Bit 5 = 1 Data set ready 


registers empty 
1 Transmitter holding register empty 
1 Break interrupt 
Framing error 
| 


Parity error 
Overrun error 
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System RAM Data 


Introduction 


The Serial Communications Services make use of control information located 
in the BIOS data area (address 40:00 - 40:100). The table below describes 
those areas. 


Length Description 

00h 4 Words 1/O address of up to 4 asynchronous communica- 
tions adapters. One word for each asynchronous 
communications adapter 

7Ch 4 Bytes Serial (RS232) time-out table for serial ports 0 
through 3. One byte per adapter. 


How the Serial Port Table is initialized 


As it identifies each RS-—232-C communications line, the CBIOS power-on 
self test (POST) places its corresponding base port address into the Serial 
Port Table (40:00h). In systems containing less than four serial ports, POST 
will initialize the base address for nonexistent ports to 0. All entries into the 
Serial Port Table are sequential. POST never writes a 0 into the Serial Port 
Table between two valid base address entries. 
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ROM BIOS Data 


Baud rate initialization table 


The Baud Rate Initialization Table is located at FOO0:E729h in the ROM BIOS. 
The table is structured as follows: 


How baud rate divisor is calculated 


The input frequency to the device is 1.8432 MHz. The values in the table are 
calculated as follows: 


1,843,200 / 16 = 115200 / Baud Rate = Divisor 


For example, a baud rate of 2400 has a divisor of 115200/2400, which 
equals 48 decimal, 30 hex. 
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Error Conditions 


Introduction 
The Serial Communications Service detects two kinds of errors: 


» Parameter-related errors 
» Time-out errors 


Parameter-related errors 


The following parameter-related conditions are checked upon entry into each 
Serial Communications Service function. 


» The function number specified in AH must fall within the range O-5. 

=» The subfunction number specified in AL (if any) must fall within the 
range O-1. 

» The serial port specified in DX must fall within the range of O-3. 

=» The serial port specified in DX must exist in hardware. 


If any of the conditions above are not true, the Serial Communications Serv- 
ice does not perform the requested function and returns with all registers 
preserved. 


Time-out errors 


A time-out error occurs when either a read or a write of a specified commu- 
nications line was unable to occur. 


The Serial Communications Service read and write functions test the Line 
Status register and the Modem Status register. When a time-out error 
occurs, the contents of the status register being tested are returned with bit 
7 “time-out error” set. 
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Function: AH = 00h Initialize Serial Communications Port 


Description 


The Initialize Serial Communications Port function initializes the selected 

adapter card from the Baud Rate, Parity, Stop Bit, and Word Length parame- 
ters specified in the AL register. The function returns with the Modem Status 
register and the line Status register in AL and AH, respectively. All other reg- 
isters are preserved. 


9600 baud limit 


The Initialize Serial Communications Port function is unable to initialize a 
baud rate above 9600 baud because of input parameter size limitations. To 
initialize the adapter card at a higher rate, use function 04h. 


Input/Output 
Input: 
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AH 
AL 


DX 


= OOh 


Serial port initialization parameters, where: 


Bits 7-5 = 


Bits 4-3 = 


Bit 2 = 


Bits 1-0 = 


Baud rate, where: 
O000b = 110 baud 
001b = 150 baud 
010b = 300 baud 
011b = 600 baud 
100b = 1200 baud 
110b = 4800 baud 
111b = 9600 baud 
Parity, where: 


OOb = None 

O1ib = Odd 

10b = None 

11b = Even 

Number of stop bits, where: 
Ob = 1 Stop bit 


1b = 2 Stop bits 

Character size, where: 
10b = 7-bit characters 
11b = 8-bit characters 


Serial port number (valid values are O, 1, 2, 3, 
where 0 = COM1, 1 = COM2, etc.) 


continued 
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Function: AH = 00h Initialize Serial Communications Port, Continued 


Input/Output, cont’d 


Output: AH = Line Status, where: 
Bit 7 = O Reserved 
Bit 6 = 1 Transmitter shift and holding register empty 
Bit 5 = 1 Transmitter holding register empty 
Bit 4 = 1 Break interrupt 
1 Framing error 
Bit 2 = 1 Parity error 
1 Overrun error 
Bit 0 = 1 Data ready 
AL = Modem Status, where: 


Bit 7 = 1 Data carrier detect 

Bit 6 = 1 Ring indicator 

Bit 5 = 1 Data set ready 

Bit 4 = 1 Clear to send 

Bit 3 = 1 Delta data carrier select 
Bit 2 = 1 Trailing edge ring indicator 
Bit 1 = 1 Delta data set ready 

Bit O = 1 Delta clear to send 
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Function: AH = 01h Send Character 


Description 


The Send Character function transmits the character supplied in AL over the 
communication line specified in DX. 


If successful, this function returns with the contents of the Line Status 
Register in AH, Bit 7 = O. If unsuccessful, AH, Bit 7 = 1. 


Input/Output 
Input: AH = Oth 
AL = Character 
DX = Serial Port Number (valid values are 0, 1, 2, 3, where 
0 = COM1, 1 = COM2, etc. 
Output: AH = Line Status Register, where: 
Bit 7 = 0 No time-out error has occurred 
Bit 6 = 1 Transmitter shift and holding register empty 
Bit 5 = 1 Transmitter holding register empty 
Bit 4 = 1 Break interrupt 
Bit 3 = 1 Framing error 
Bit 2 = 1 Parity error ~ 
Bit 1 = 1 Overrun error 
Bit O = 1 Data ready 
AL = Character sent (unchanged) 


Error conditions 


When a time-out error occurs during the execution of the Send Character 
function, the value returned in AH can reflect the state of either the Modem 
Status Register or of the Line Status Register. However, since bit 7 of AH is 
used to report that an error has occurred, it is not available to report a 
time-out error. For this reason, if this function or INT 14h function 02h re- 
ports an error, it is preferable to use INT 14h function 03h, which gives a 
complete status report, rather than the less—complete status bits returned 
with the error bit in functions 01h and O2h. 


342 CBIOS for IBM PS/2 Computers and Compatibles 


Function: AH = 02h Receive Character 


Description 


The Receive Character function receives one character from the serial port 
specified in the DX register. 


If successful, this function returns with the character received in the AL reg- 
ister. The contents of the Line Status Register is returned in the AH register. 


Input/Output 
Input: AH = O2h 
DX = Serial port number (Valid values are 0, 1, 2, 3, 
where 0 = COM1, 1 = COM2, etc.) 
Output: AH = Line Status Register, where: 


Bit 7 = O No time-out error has occurred 
Bit 6 = 1 Transmitter shift and holding register empty 
Bit 5 = 1 Transmitter holding register empty 
Bit 4 = 1 Break interrupt 
Bit 3 = 1 Framing error 
Bit 2 = 1 Parity error 
Bit 1 = 1 Overrun error 
Bit O = 1 Data ready 
AL = Character received 


Error conditions 


lf a time-out error occurs during the execution of the Receive Character 
function, the value returned in AH can reflect the state of either the Modem 
Status Register or of the Line Status Register. However, since bit 7 of AH is 
used to report that an error has occurred, it is not available to report a 
time-out error. For this reason, if this function or INT 14h function Oth re- 
ports an error, it is preferable to use INT 14h function 03h, which gives a 
complete status report, rather than the less—complete status bits returned 
with the error bit in functions 01h and O2h. 
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Function: AH = 03h Read Serial Port Status 


Description 


The Read Serial Port Status function returns the current Modem Status in the 
AL register and the current Line Status in the AH register. All other registers 
are preserved. 


Input/Output 
Input: AH = O3h : 
DX = Serial port number (Valid values are 0, 1, 2, 3, where 
O = COM1, 1 = COM2, etc.) | 
Output: AH = Line Status, where: 


Bit 7 = O Reserved 
Bit 6 = 1 Transmitter shift and holding register empty 
Bit 5 = 1 Transmitter holding register empty 
Bit 4 = 1 Break interrupt 
Bit 3 = 1 Framing error 
Bit 2 = 1 Parity error 
Bit 1 = 1 Overrun error 
Bit O = 1 Data ready 
AL = Modem status, where: 
Bit 7 = 1 Data carrier detect 
Bit 6 = 1 Ring indicator 
Bit 5 = 1 Data set ready 
Bit 4 = 1 Clear to send 
Bit 3 = 1 Delta data carrier detect 
1 Trailing edge ring indicator 
Bit 1 = 1 Delta data set ready 
1 Delta clear to send 
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Function: AH = 04h Extended Initialize 


Description 


The Extended Initialize function does an extended initialization of the adapter 
card selected in the DX register based on the Break, Parity, Stop Bit, Word 
Length, and Baud Rate values placed in the BH, BL, CH, and CL registers. 
This function is a superset of function OOh. 


The function returns with the Modem Status Register and the Line Status 
Register in the AL and AH registers, respectively. 


This function must be used to initialize baud rates greater than 9600. 


Input/Output. 
Input: AH = O4h 

AL = Break, where: 
OOh = No break 
Oih = Break 

BH = Parity, where: 
OOh = None 
Oih = Odd 
O2h = Even 
O3h = Stick parity odd 
04h = Stick parity even 

BL = Stop Bit, where: 


00h = One 
Oth = Two if 6-, 7-, or 8- bit word length 
One-and-one-half if 5-bit word length 
CH = Word length, where: 


OOh = 5 Bits 
Oih= 6 Bits 
02h = 7 Bits 


O3h = 8 Bits 


continued 
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Function: AH = 04h Extended Initialize, Continued 


Input/Output, cont’d 


Input: CL = Baud rate, where: 

(cont’d) OOh = 110 Baud 
Oih = 150 Baud 
O2h = 300 Baud 
03h = 600 Baud 
04h = 1200 Baud 
O5h = 2400 Baud 
O6h = 4800 Baud 
O7h = 9600 Baud 
O8h = 19200 Baud 


DX = RS-232-C communications line to use (Valid values are 
0, 1, 2, 3, where 0 = COM1, 1 = COM2, etc.) 
Output: AH = Line Status 


Bit 7 = O Reserved 
Bit 6 = 1 Transmitter shift and holding register empty 
Bit 5 = 1 Transmitter holding register empty 
Bit 4 = 1 Break interrupt 
Bit 3 = 1 Framing error 
Bit 2 = 1 Parity error 
Bit 1 = 1 Overrun error 
Bit O = 1 Data ready 
AL = Modem Status 
Bit 7 = 1 Time—out error 
Bit 6 = 1 Ring indicator 
Bit 5 = 1 Data set ready 
Bit 4 = 1 Clear to send 
Bit 3 = 1 Delta data carrier detect 
Bit 2 = 1 Trailing edge ring indicator 
Bit 1 = 1 Delta data set ready 
Bit O = 1 Delta clear to send 


| 
— 
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Function: AH = 05h Extended Serial Port Control 


Introduction 


The Modem Control Register is an 8—-bit register that controls data exchange 
with the modem, data set, or peripheral device emulating a modem. 


The Extended Serial Port Control function will either read from or write to the 
Modem Control Register depending on the parameter input into the AL regis- 
ter. The two subfunctions and their AL register parameter values are listed 
below: 

» AL = 00h Read the Modem Control Register 

» AL = O1h Write to the Modem Control Register 


continued 
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Function: AH = 05h Extended Serial Port Control, Continued 


Subfunction: AL = 00h read the modem control register 


This subfunction reads the NS 16550 (or compatible) Modem Control Reg- 
ister and returns the value in BL. The Modem Status Register is returned 


O5h Extended serial port control 

OOh Read the Modem Control Register 

RS-232-C communications line to use (Valid values are 
0, 1, 2, 3, where 0 = COM1, 1 = COM2, etc.) 


Line Status, where: 

Bit 7 = 0 Reserved 

Bit 6 = 1 Transmitter shift and holding register empty 
Bit 5 = 1 Transmitter holding register 
Bit 4 = 1 Break interrupt 

Bit 3 = 1 Framing error 

Bit 2 = 1 Parity error 

Bit 1 = 1 Overrun error 

Bit O = 1 Data ready 

Modem status, where: 

Bit 7 = 1 Data carrier detect 

Bit 6 = 1 Ring indicator 

Bit 5 = 1 Data set ready 

Bit 4 = 1 Clear to send 

Bit 3 = 1 Delta data carrier detect 
Bit 2 = 1 Trailing edge ring indicator 
Bit 1 = 1 Delta data set ready 

Bit O = 1 Delta clear to send 
Modem Control Register, where: 
Bits 7-5 = O Reserved 

Bit4 = 1 Loopback mode 


Bit3 = 1 Enable OUT2 interrupt 

Bit 2 = 1 Force OUT1 active 

Bit 1 = 1 Force request-to-send active 
BitO = 1 Force data-terminal-ready active 


All other registers are preserved. 


in AL. 
Input/Output 
Input: AH 
AL 
DX 
Output: AH 
AL 
BL 
348 


continued 
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Function: AH = 05h Extended Serial Port Control, Continued 


Subfunction: AL = 01h write modem control register 


This subfunction writes the value placed in BL to the NS 16550 Modem Con- 
trol Register. The subfunction returns with the value written to the Modem 
Control! Register in BL, the Modem Status register in AL, and the Line Status 
register in AH. 


Input/Output 


Input: AH = O5h Extended Serial Port Control 
AL = Oth Write Modem Control Register 
BL = Modem Control Register, where: 
Bits 7-5 = O Reserved 
Bit 4 1 Loopback mode 
Bit 3 = 1 Enable OUT2 interrupt 
Bit 2 = 1 Force OUT1 active 
Bit 1 = 1 Force request-to-send active 
Bit O = 1 Force data-terminal-ready active 
DX = RS-232-C communications line to use (Valid values are 
O, 1, 2, 3, where 0 = COM1, 1 = COM2, etc.) 


Output: AH = Line Status, where: 
Bit 7 = 0 Reserved 
Bit 6 = 1 Transmitter shift and holding register empty 
Bit 5 = 1 Transmitter holding register 
Bit 4 = 1 Break interrupt 
Bit 3 = 1 Framing error 
Bit 2 = 1 Parity error 
Bit 1 = 1 Overrun error 
Bit O = 1 Data ready 
AL = Modem status, where: 


Bit 1 = 
Bit O = 


Delta data set ready 
Delta clear to send 


Bit 7 = 1 Data carrier detect 

Bit 6 = 1 Ring indicator 

Bit 5 = 1 Data set ready 

Bit 4 = 1 Clear to send 

Bit 3 = 1 Delta data carrier detect 

Bit 2 = 1 Trailing edge ring indicator 
1 
1 


continued 
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Function: AH = 05h Extended Serial Port Control, Continued 


Subfunction: AL = Oth, cont’d 


Output: BL = Modem Control Register, where: 
(cont’d) Bits 7-5= O Reserved 
| Bit4 = 1 Loopback mode 
Bit 3 = 1 Enable OUT2 interrupt 
Bit 2 = 1 Force OUT1 active 
Bit 1 = 1 Force request-to-send active 
Bit 0 = 1 Force data-terminal-ready active 


All other registers are preserved. 


Functions: AH = 06h —- FFh Reserved 
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Chapter 13 
INT 15h System Services 


Overview 


Introduction 


INT 15h, System Services, provides several services: 


= ABIOS initialization routines 


The CBiOS System Services contain two functions that are caiied during 
ABIOS initialization. These services are reserved exclusively for operating 
systems that employ the ABIOS. 


w Multitasking hooks 


The CBIOS provides six hooks for use by multitasking operating systems. 
In a DOS environment (which is not a multitasking Operating system) 
these six functions do nothing except return to the caller. A multitasking 
operating system would normally intercept these function calls by 
replacing the INT 15h vector and processing these function calls itself. 


= Joystick support 
Function 84h supports up to two joysticks. Function 84h has two subfunc- 
tions: read current switch settings and read resistive inputs. 


continued 
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Overview, Continued 


Introduction, cont'd 
= Wait routines 
INT 15h provides two wait functions: Function 83h, Set Event Wait Interval, 
and Function 86h, Wait. Function 86h does not return control to the caller 
until a specified interval is completed. Function 83h returns control to 
the caller. 
= Protected mode support 


The CBIOS System Services provides limited protected mode support 
through two functions: Function 87h, Move Block, and function 89h, Switch 
Processor to Protected Mode. 


The ABIOS provides full protected mode, bimodal, and real mode ad- 
dressing support. 

= Pointing device interface 
INT 15h function C2h provides complete mouse support. 


= System information 


Function COh, Return System Configuration Parameters, Function Cth, 
Return Extended BIOS Data Area Segment Address, Function C3h, Watch- 
dog time-out, and Function C4h, Programmable Option Select, provide 
detailed system services. 


How INT 15h services are invoked 
INT 15h invokes the CBIOS System Services. 


The INT 15h vector resides at Interrupt table address 00:3Ch. To insure 
compatibility, the CBIOS initializes the INT 15h vector to FOOO:F859h. 


Individual System Services functions are selected via the AH register. 
Subfunctions are selected via the AL, DX, or BH registers. 


continued 
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Overview, Continued 


Summary of INT 15h system services 


The table below lists the System Services functions and subfunctions. 


Note: Functions AH = 80h, 81h, 82h, 85h, 90h, and 91h (i.e. those marked 
with an asterisk in the table below) are multitasking hooks. A multi- 
tasking operating system would normally intercept these function calls 
by replacing the INT 15h vector and processing these function calls 
itself. In DOS (which is not a multitasking operating system) these six 
functions do nothing except return immediately to the caller with the 
Carry Flag cleared. 


Description 


oon-osh_ | Reserved 


04h Build System Parameters Table 


Build Initialization Table 


Format ESD! Drive Periodic Interrupt 


2th Power-On Self Test Error Log 


AL = 00h Read POST Error Log 
AL =0O1h Write Error Code to POST Error Log 


22h-4Eh 
4Fh 
Oh 


Reserved 


Keyboard Intercept 


Device Open* 


Program Termination* 


Set Event Wait Interval 

AL =00h _~ Set Wait 
AL =01h Cancel Wait 
Joystick Support 


DX = 00h Read Current Switch Settings 
DX = Oth Read Resistive Inputs 


8 


83h 


85h System Request Key* 


* Multitasking hooks (described in note above) 
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Overview, Continued 


Summary of INT 15h System Services, cont’d 


AH Value Description 


Move Block 
88h 


a ee Read Extended Memory Size 


Switch Processor to Protected Mode 


[eatoarh | peeved 


Pointing Device Interface 


AL = 00h Enable/Disable Pointing Device 
AL =01h Reset Pointing Device 
AL = 02h Set Sample Rate 
AL = 03h Set Resolution 
AL = 04h Read Device Type 
AL =05h _ Pointing Device Interface Initialization 
= 06h Extended Commands 
BH = 00h Return Status 
= Oth Set Scaling Factor to 1=1 
= 02h Set Scaling Factor to 2=1 
AL 07h Device Drive Far Call Initialization 


Watchdog Time-out 


AL = 00h Disable watchdog time-out 
AL = 0th Enable watchdog time-out 


Programmable Option Select 


AL = 00h Return Base Position Adapter Register 
Address 

AL =0O1h ~~ Enable Cursor for Setup 

AL =02h £Adapter Enable 


continued 
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Overview, Continued 


In this chapter 
The following topics are discussed in the rest of the INT 15h System 
Services chapter: 
» Hardware Environment 
» System Services I/O Ports 
» System RAM Data 
» Extended System RAM Data 
= CMOS RAM Data 
« ROM BIOS Data 
» System Services Functions 
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Hardware Environment 


The INT 15h System Services routines assume the existence of two 8259A 
Programmable Interrupt Controllers, an 8237 DMA controller, an 8254 pro- 
grammable interval timer/counter chip, and an 8042/8242 keyboard controller 
or equivalents thereof. 


These routines deal with input/output devices, including keyboards, mouse 
pointing devices, joysticks, touch pads, track balls, RS-232 devices, and 
other serial devices. 


System Services I/O Ports 


INT 15h, System Services, references the following |/O ports: 


Read/Write 
1/O Address ' Status Description 


| oo20h | lw Programmable interrupt controller 1 
| oozth S| WC Programmable interrupt controller 1 mask 


0040h R/W Programmable Interrupt Timer - Read/write 
counter 0 


Control byte for timers 0 and 2, where: 


Bits 7-6 = timer select, where 
= select timer 0 
O1b = reserved 
10b = select timer 2 
Bits 5-4 = timer action where: 
00b =counter latch command 
01b =read/write counter bits 0-7 
only 
10b = esei ete counter bits 8-15 
only 
11b = Read/write counter bits 0-7 
first, then bits 8-15 
Bits 3-1 = timer mode where 
000b = mode 0 select 
001b = mode 1 select 
X10b = mode 2 select 
X11b = mode 3 select 
100b = mode 4 select 
101b = mode 5 select 
Bit 0 = 1 binary coded decimal counter 
= 0 binary counter 16 bits 


continued 
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System Services I/O Ports, Continued 


Read/Write 
1/O Address Status Description 


0044h Timer 3 counter register 


0047h W Control byte for timer three where: 
Bits 7-6 = 00b select timer 3 
Bits 5-4 = 00b counter latch command 
= 01b read/write counter bit 0-7 only 
Bits 3-0 = 0 reserved 


0060h Keyboard/auxiliary data. port | 


0061h System control port B, where: 
Bit 7 = 1 Parity check 
Bit 6 = 1 Channel check 
Bit 5 = 1 Timer 2 output 
Bit 4 = 1 Toggle with each refresh request 
Bit 3 = 0 Channel check enabled 
Bit 2 = 0 Parity check enabled 
Bit 1 = 1 Speaker data enabled 
Bit 0 = 1 Timer 2 gate to speaker enabled 


W System control port B, where: 
Bit 7 = 1 Reset timer 0 output latch (IRQ 0) 
Bits 6-4 = Reserved 
| Bit 3 = 0 Enable channel check 
Bit 2 = 0 Enable parity check 
Bit 1 = 1 Speaker data enable 
Bit 0 = 1 Enable timer 2 gate to speaker 


8042 Status, where: 


Bit 7 = 1 Parity error 

Bit 6 = 1 General time out 

Bit 5 = 1 Auxiliary output buffer full 
Bit 4 1 Inhibit switch 


1 Command/data 
maria flag 
1 


Input buffer full 
Output buffer full 


CMOS RAM address register port, where: 


Bit 7 = 1 NMI disable 
Bits 6-O = 0 CMOS address 


System control port A, where: 


Bit 7 = 1 Fixed disk activity light bit A is on 
Bit 6 = 1 Fixed disk activity light bit B is on 


0 Reserved 

1 Watchdog time-out occurred 
1 Security lock latch locked 
Reserved 

1 Alternate gate A20 active 

1 Alternate hot reset 


continued 
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System Services I/O Ports, Continued 


358 


Read/Write | 
1/O Address Status Description 


WwW System board setup enable register, where: . 


Bit 7 = 0 Enable system board setup 
Bit 6 = 1 Reserved 
Bit 5 = 0 Enable VGA setup 


Bits 4-0 = 1 Reserved 


Channel position select register, where: 


Bit 7 = 1 Channel reset | 
Bits 6-4 = Reserved (written as 0, read as 1 
Bit 3 = 1 Channel select 


Bits 2-0 = Channel number 


O0AOh pW Programmable Interrupt Controller 2 


WwW 
O0Ath R/W Interrupt Controller 2 mask, where: 


Bit 7 = 0 Reserved 

Bit 6 = 0 Enable fixed disk interrupt 

Bit 5 = 0 Enable 80387 exception interrupt | 
Bit 4 = 0 Enable mouse interrupt 

Bit 3 = 0 Reserved 

Bit 2 = 0 Reserved 

Bit 1 = 0 Enable redirect cascade 

Bit 0 = 0 Enable real time clock interrupt 


| oooh {| RR System board or adapter ID (low byte) 
| ototh fll System board or adapter ID (high byte) 
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System RAM Data 


System RAM data table 


The following table shows the data definitions used by INT 15h. The data 
definitions are stored in system RAM in segment 40h. 


Description 


Least significant wait count 
Most significant wait count 


Wait active flag, where: 


Bit 7 = 1 Wait time elapsed 
Bits 6-1 = Reserved 
Bit 0 = 1INT 15h, AH = 86h occurred 
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Extended System RAM Data 


Extended System RAM Table 


The following table provides the name, length, location, and description of all 
extended System RAM data areas used by the auxiliary device service: 


EDA:17h | 1 Byte Number of error codes in the POST error log 


EDA: 18h POST error log 
EDA:38h | 1 Byte — | Watchdog timer initial count | 


EDA:22h 


1 Word Device drive offset 
EDA:24h Device driver segment 
EDA:26h 1 Byte Pointing device flag (Flag 1) 
Bit 7 = 1 Command in progress 
Bit 6 = 1 Resend received from auxiliary device 
| Bit 5 = 1 Acknowledge received from auxiliary 
device 
Bit 4 = 1 BAT failure received from auxiliary 
| | device 
| Bits 3-0 = Data package size counter (in bytes) 


Pointing device flag (Flag 1) 


Bit 7 = 1 Device driver far call installed 

Bit 6 = 1 Pointing device interface installed 
Bit 5 = Reserved 

Bit 4 = Reserved 


Bits 3-0 = Data package size (in bytes) 


/ 


Note: EDA = Segment of Extended System RAM Data Area. 
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CMOS RAM Data 


CMOS RAM data area table 


The following table describes all CMOS RAM locations used by the INT 15h 


System Services routines: 


OFh 


1 Byte 


il 


Status register B, where: 


Bit 7 = 0 Run 

= 1 Halt 
Bit 6 = 1 Enable periodic interrupt 
Bit 5 = 1 Enable alarm interrupt 


Bit 4 = 1 Enable update-ended interrupt 

Bit 3 = 1 Enable square wave interrupt 

Bit 2 = 1 Calendar is in binary format 
Calendar is in BCD format 

Bit 1 24-hour mode 

Bit O 


12-hour mode 
Enable Daylight Savings Time 


Reason for shutdown, where: 


OOh = Power on or soft reset 

Oih = Memory size pass 

Memory test pass 

Memory test fail 

04h = POST end; boot system 

05h = JMP dword pointer with end-of-interrupt 

O6h = Protected tests pass 

07h = Protected tests fail 

08h = Memory size fail 

09h =INT 15h Block Move 

OAh = JMP dword pointer without end-of- 
interrupt 

OBh = Used by ABIOS 


(o) 

NO 

=) 
Hou 


Miscellaneous information 
Bits 7-4 = Actual number of RS-232 ports installed 


Bits 3-0 = Block move status before reset to real 
mode 


| 85h] Byte Low byte of actual expansion memory size 
| 8h 1 Byte | High byte of actual expansion memory size 
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ROM BIOS Data 


System configuration table 


The System Configuration table is located in the CBIOS ROM at FOOO:E6F5h. 
This table can be called into RAM via INT 15h function AH = COh Return 
System Configuration Parameters. 


Initial 
value Length Description 


| ooh | 0 | 1 Word | Number of bytes in this table (minimum = 8) 


Model byte, where: 


Model 80 = F8h 
Model 70 


Model 30 
Model 25 = FAh 
Unknown system board = FFh 


Submodel byte, where: 


Model 80 = 00h or Oth 
Model 70 = 09h 
Model 60 = 05h 
Model 50 = 04h 
Model 30 = 00h 
Model 25 = Oth 


Unknown system board = FFh 


| o4h || 1 Byte BIOS revision level (first release = 00b) 


Feature information byte, where: 


Bit 7 = 1 Fixed disk BIOS uses DMA channel 3 

Bit 6 = 1 Second interrupt chip present 

Bit 5 = 1 Real time clock present 

Bit 4 = 1 Keyboard intercept (INT 15h, function 
AH = 4Fh) called by keyboard interrupt 
service (INT 09h) 


Bit 3 = 1 Wait for external event supported 
Bit 2 = 1 Extended BIOS data area is allocated 
Bit 1 = 1 Micro Channel supported 


= 0 PC-type I/O channel implemented 
Bit 0 = 0 Reserved 


ae 1 Byte Feature information byte 2 (reserved, zeros) 
i 1 Byte Feature information byte 3 (reserved, zeros) 
a 1 Byte Feature information byte 4 (reserved, zeros) 


Feature information byte 5 (reserved, zeros) 
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Functions: AH = 00h - 03h Reserved 


Function: AH = 04h Build System Parameters Table 


Description 


The System Parameters table lists the system stack requirements, the num- 
ber of devices installed in the system, and entry points of the ABIOS Com- 
mon Entry routines. An operating system (e.g. MS OS/2) calls this CBIOS 
function during the first step in initializing ABIOS. This function preserves the 
interrupt flag and the contents of the DS register. 


This function should only be called by operating systems that make use 
of the ABIOS. Calling this function from within DOS will give unpredictable 


results. 
Input: AH = 04h 
ES:D! = Pointer to location in RAM where the table is to be built. 
DS = Segment of the Extended System RAM data area. 
(Offset is assumed to be O0O00h) 
Output: AH = OOh If function was successful 
CF = 1 Exception error has occurred 


Note: All registers except AX and flags are restored. 


For more information 


For more information on ABIOS initialization, refer to the volume, AB/OS for 
IBM PS/2 Computers and Compatibles, in this series. 
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Function: AH = 05h Build Initialization Table 


Description 


The ABIOS Initialization Table describes the initialization information for each 
device ABIOS is to support. An operating system (e.g. MS OS/2) calls this 
CBIOS function during the second step in initializing ABIOS. This function 
preserves the interrupt flag and the contents of the DS register. 


This function should only be called by operating systems that make use 
of the ABIOS. Calling this function from within DOS will give unpredictable 


results. 
Input: AH = QO5h 
ES:DI = Pointer to location in RAM where the table is to be built. 
DS = Segment of the Extended System RAM data area. 
(Offset is assumed to be OO0O0h) 
Output: AH = OOh If function was successful 
CF = 0 No error 


1 Exception error has occurred 


Note: All registers except AX and flags are restored. 


For more information 


For more information on ABIOS initialization, refer to the volume, AB/OS for 
IBM PS/2 Computers and Compatibles, in this series. 


Functions: AH = 06h-0Eh Reserved 
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Function: AH = OFh Format ESDI Drive Periodic Interrupt 


Description 


The BIOS uses this function on an ESDI Fixed Disk Drive Adapter/A when 
doing a format or surface analysis operation and after each cylinder is 
completed. Refer to INT 13h, function AH = 1Ah Format ESDI Drive. These 
devices generally require an option ROM. 


Input: AH = OFh 
AL = Phase code 
= Q Reserved 
= 1 Surface analysis 
= 2 Formatting 


Output: CF = O Formatting or analysis should continue 
= 1 Formatting or analysis should be stopped 


Additional information 


»s A program can intercept this function call so it will be informed as each 
cylinder is formatted or analyzed. The program could count the interrupts 
for each phase to get the current cylinder number. 


» The BIOS default handler for this function will return with the carry flag set. 


= For other types of fixed disk adapters, this function is reserved. Also, not 
every BIOS implements this function. 


Function: AH = 10h - 20h Reserved 
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Function: AH = 21h Power-On Self Test Error Log 


Description 


This function has two subfunctions which actually read and write to and from 
the POST error log. This error log holds one word (16 bit) error codes which 
are used by the reference diskette to select the appropriate diagnostic 
message. These subfunctions are called by entering either OOh or Oth in 
register AL. If any other value is in AL, AH is set to two, one is subtracted 
from AL, CF is set to one, and control is returned to the caller. 


The error log is stored at 40:27h in the extended system RAM data area. Up 
to five errors can be logged into the array. The number of error codes 
logged is stored in 40:26h. 


Models 25 and 30: This function is not available on IBM PS/2 Models 25 and 
30 (and compatibles). 


21h 

OOh Read POST error log 

O1h Write error code to POST error log 
Output: CF = O No error | 

1 Invalid input 


Input: AH 
AL 


Subfunction: AL = 00h Read POST error log 


This subfunction returns the number of logged error codes and a pointer to 
the error log. The information returned in this function reflects the results of 
the last POST that was performed. 40:26h contains the number of error 
codes. 40:27h is the pointer to the POST error log, which is made up of 
single word entries. The first byte is the device error code. The second byte 
is the device identifier. 


Input: AH = 2th 
AL = OOh 
CF = 0 
Output: AH = 00h 
BH = Q0Oh 
BL = Number of POST error codes stored 
ES:DI = Pointer to POST error log. 


continued 
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Function: AH = 21h Power-On Self Test Error Log, Continued 


Subfunction: AL = 01h Write error code to POST error log 


This subfunction stores the device and error code in BX into the POST error 
log. If the maximum number of errors (5) is already stored, this code is not 


stored. 

Input: AH = 21h 
AL = Oth 
BH = Device code 
BL = Device error 


Output: AH = OOh Successful 
= Qih Error code; location full 


AL = _ Index into error log, if successful 
= 05h Error code; location full 
CF = QNOo error 


= 1 Error code location full (AH = 01h; AL = 05h) 


Error conditions 


No error codes are stored if the maximum number of codes is already 
stored. If the maximum number of error codes is already stored, AH is set 
to one, AL to 5, CF to 1, and control is returned to the caller. 


Functions: AH = 22h —- 4Eh Reserved 
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Function: AH = 4Fh Keyboard Intercept 


Description 


The keyboard interrupt function is called by INT 09h when any key is 
pressed. This function returns the scan code in AL with CF = 1. This func- 
tion can be used to scan codes to create alternate keyboard layouts, and to 
cause systems to ignore certain keystrokes. 


An operating system or resident utility can intercept this function in order to 
filter the raw keyboard data stream. A new handler can be written to substi- 
tute a different scan code, return the existing scan code, or return the carry 
flag cleared (thus causing the keystroke to be discarded). | 


Input: AH = 4Fh 


Output: AL = Scan code 
CF = O Keystroke unchanged (original scan code in AL) 
= 1 Keystroke changed (new scan code in AL) 


INT 15h function COh can be called to see if a machine’s BIOS supports the 
keyboard intercept function. | 


Functions: AH = 50h - 7Fh Reserved 
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Function: AH = 80h Device Open 


Description 


This function is used by multitasking operating systems. A multitasking 
operating system would point INT 15h to itself, intercept this function, and 
process the request as necessary. This is a way of capturing control of a 
logical device so as to arbitrate its usage by multiple processes. 


Input: AH = 80h 
BX = Device ID 
CX = Process ID 


Output: AX = O080h 


Function: AH = 81h Device Close 


Description 


This function is used by multitasking operating systems. A multitasking 
operating system would point INT 15h to itself, intercept this function, and 
process the request as necessary. This function releases control of a logical 
device for a process. See also INT 15 functions 80h and 82h. 


Input: AH = 8th 
BX = Device ID 
CX = Process ID 


Output: AX = O081h 
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Function: AH = 82h Program Termination 


Description 
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This function is used by multitasking operating systems. A multitasking 
operating system would point INT 15h to itself, intercept this function, and 
process the request as necessary. This function releases control of all 
logical devices for a process that will soon terminate. See also INT 15h 


functions 80h 81h. 


Input: 


Output: 


AH 
BX 


AX 


82h 
Device !D 


0082h 
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Function: AH = 83h Set Event Wait Interval 


Description 


INT 15h provides two wait functions: Function 83h, Set Event Wait Interval, 
and Function 86h, Wait. Function 86h does not return control to the caller 
until a specified interval is completed. Function 83h returns control to 

the caller. 


Models 25 and 30: This function is not available on IBM PS/2 Models 25 and 
30 (and compatibles). 


Input: AH = 83h 
AL OOh Set wait function 
01h Cancel wait function 
Output: CF = O No error 
= 1 Invalid input 


Error conditions 


If the subfunction code in AL is not OOh or Oth, one is subtracted from AL, 
CF is set to one, and control is returned to the caiier. 


Additional Information 
» An event wait’s duration is an integral multiple of 976 microseconds. This 
function is implemented with CMOS date/clock interrupts. 


» Use this function to get programmed, hardware-independent delays of 
finer granularity than provided with the MS-DOS Get Time function (INT 
21h function 2Ch). The latter returns time only in hundredths of a second. 

» See also INT 15h function 86h, Wait, which halts the calling program for 
an interval specified in milliseconds. 


continued 
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Function: AH = 83h Set Event Wait Interval, Continued 


Subfunction: AL = 00h Set interval 


This subfunction starts the wait requested the calling routine if no wait has 
already been started. If a wait has already been started, control is returned 
to the caller with CF set to one. 


Input: AH = 
AL 


OQ 
x xX 
non 


ES:BX = 


Output: AH 


> 
- 
iH 


© 
oA 
i 


83h 

OOh 

Microseconds until posting (high byte) 

Microseconds until posting (low byte) 

Pointer to byte in caller’s memory that will have bit 7 set 
when the interval expires 


83h 

A value written to CMOS register B, if successful 
OOh Function busy 

O No error 

1 Error, function busy 


Subfunction: AL = 01h Cancel set interval 


This function cancels the interval in progress. 


Input: AH = 
AL = 
Output: AX = 
GE. = 


83h 

Oth 

8300h 

O No.error 
1 Error 


372 


CBIOS for IBM PS/2 Computers and Compatibles 


Function: AH = 84h Joystick Support 


Description 


This function controls a joystick connected to the game control adapter. It 
has two subfunctions: read current joystick switch settings and read resis- 
tive inputs. 


Input: AH 84h 

DX = OOh Read current switch setting subfunction 
O1h Read resistive inputs subfunction 
Output: CF = O No error 
1 Error 


Error conditions 


CF is set to one if the value in DX is not OOh or Oth. 


Subfunction: DX = 00h Read current switch settings 


This subfunction returns the switch settings read from the joystick in bits 4 
through 7 of AL. The switch settings are at port O201h. Bits 3-0 of AL are 


set to zero. 
Input: AH = 84h 
DX = OOh 
Output: AH = DH on entry to this function 


AL = Switch settings in bits 7-4, Bits 3-0 = 0 


continued 
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Function: AH = 84h Joystick Support, Continued 


Subfunction: DX = 01h Read resistive inputs 


This subfunction retrieves the relative position of the X and Y coordinates 
of the two possible joysticks. Control is returned to the caller and CF is set 


to zero. 


Input: 


Output: 


AH 
DX 


AX 
BX 
CH 
DX 


84h 
Oth 


Joystick A X-coordinate value 
Joystick A Y-—coordinate value 
Joystick B X-—coordinate value 
Joystick B Y-coordinate value 


Note: With a 250K Ohm joystick connected, potentiometer values will be 
around 0-416 (O000-01A0h). 


Function: AH = 85h System Request Key 


Description 
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This function is used by multitasking operating systems. A multitasking 
operating system would point INT 15h to itself, intercept this function, and 
process the request as necessary. The function is called by the BIOS key- 
board driver when the SysReq key is pressed. 


Input: 


Output: 


AH 
AL 


AX 


85h 
OOh Key make 
O1h Key break 


0085h 
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Function: AH = 86h Wait 


Description 


INT 15h provides two wait functions: Function 83h, Set Event Wait Interval, 
and Function 86h, Wait. Function 86h does not return control to the caller 
until a specified interval is completed. Function 83h returns control to 


the caller. 
Input: AH = 86h 

CX = High byte of wait interval (in microseconds) 

DX = Low byte of wait interval (in microseconds) 
Output: AH = 86h 

AL = Mask written to interrupt controller 2 (if successful) 


= Unmodified if function busy 
CF = OQ No error 
= 1 Function busy 


Error conditions 


lf a wait is already in progress, CF is set to one and control is returned to 
the caller. 


_ | CBIOS Function Effects on CBIOS RTC ISR 


INT 15h: AH = 83h Event Wait Interval These functions activate the CBIOS Real 


INT 15h: AH = 86h Wait Time Clock ISR’s Periodic Interrupt 
component. 


INT 1Ah: AH = 06h Set User Alarm This function activates the CBIOS real time 
clock ISR’s Alarm Interrupt component. 


Additional information 


» The wait’s duration is an integral multiple of 976 microseconds. 


« Use this function to get programmed, hardware-independent delays of 
finer granularity than provided with the MS-DOS Get Time function (INT 
21h function 2Ch). The latter returns time only in hundredths of a second. 
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Function: AH = 87h Move Block 


Description 
This function moves a block of memory for a real mode program to or from 
extended memory by switching to protected mode. Conventional memory is 
located at addresses below 640K. Only this area can be accessed by 
MS-DOS and its application programs. Extended memory is located at ad- 
dresses above 1 MB, and has to be accessed by an 80286 or 80386 operat- 
ing in protected mode. The caller must build a Global Descriptor Table with 
the specified settings as input to this function. 


Models 25 and 30: This function is not available on IBM PS/2 Models 25/30 
(and compatibles). 


Global Descriptor Table 
The caller supplies a pointer in ES:SI to a global descriptor table (GDT) that 
contains six entries. These entries must be: 
= Dummy (must be zero). 


= Global descriptor table (must be zero): points to the data segment where 
the GDT is located; can be modified by the CBIOS. 


=» Source address (initialized by caller): points to the source block that is to 
be moved. 


» Destination address (initialized by caller): points to the address where the 
block is to be moved. | 


= BIOS code segment (must be zero): the CBIOS uses this entry to create a 
protected mode code segmert. 


= Caller stack segment (must be zero): the CBIOS creates a protected 
mode stack segment here. 


initial Value (hex) Description 


00000000h | Dummy entry 
00000000h Location of GDT 


User-supplied address Address of source GDT 


00000000h Destination address 


00000000h Caller’s stack segment | 


continued 
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Function: AH = 87h Move Block, Continued 


Function processing 


ES:SI points to a global descriptor table (GDT) that the caller builds before 
calling this function. The descriptors in this table perform a block move 

in protected mode. The data access right byte should be set to 93h in 
order to permit access to the data. The 24-bit address must be set to the 
target/source. 


The Timer O latch is not cleared by this function. Bits 0-3 of CMOS location 
34h are cleared upon completion of this function. 


Interrupts are disabled while the block move is performed. For this reason, 
using this function may interfere with software such as communications pro- 
grams and network drivers that depend on prompt servicing of hardware 
interrupts. 


Processor-specific information 


On 80386-based systems, 32-bit moves are performed. The CBIOS uses 1/O 
port 0092h to reset the processor on 80286-based systems. 


Input/Output 
Input: AH = 87h 
CX = Block size to be moved (0-8000h words). 
ES:SI = Pointer to global descriptor table 
Output: AH = 00h Successful move 
= Q1h RAM Parity error occurred 
= 02h Other exception interrupt error 
CF = 0 No error 
= 1 Error 
ZF = OQ Unsuccessful move 


1 Successful move 


Error conditions 


lf an exception interrupt occurs during the block move, AH is set to 02h. CF 
is set to one, ZF is set to zero, and control is returned to the caller. 


If a parity error occurs, AH is set to 01h, CF is set to one, ZF is set to zero, 
and control is returned to the caller. 
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Function: AH = 88h Read Extended Memory Size 


Description 


The Read Extended Memory Size function reads the size of the extended 
memory stored in CMOS locations 35h and 36h (beginning at address 
(100000h) and stores the combined contents as a word in the AX register. 


Models 25 and 30: This function is not available on IBM PS/2 Models 25 and 
30 (and compatibles). 


Input: AH = 88h 
Output: AX 


Number of contiguous 1K blocks of extended memory 
starting at address 1024K (100000h) 


Additional information 


» The system may not be able to use the extended memory unless the 
system board is fully populated. 


» Extended memory is located at addresses above 1 MB, and has to be 
accessed by an 80286 or 80386 operating in protected mode. As MS-DOS 
is a real mode operating system, extended memory cannot be used for 
executing its programs. Extended memory can, however, be used to store 
volatile data. 
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Function: AH = 89h Switch Processor to Protected Mode 


Description 


The Switch Processor to Protected Mode function sets the processor into 
protected mode and passes control to the code segment pointed to in the 
GDT (global descriptor table). 


Models 25 and 30: This function is not available on IBM PS/2 Models 25 and 
30 (and compatibles). 


Input: AH = 89h 
BH = Offset within IDT that defines where first 8 hardware 
interrupts are based 
BL = Offset within IDT that defines where second 8 hardware 


interrupts are based 
ES:SI = Pointer to GDT built by user 


Output: AH = QOh successful (CF = 0). Returns in protected mode 
= FFh Unsuccessful 
CF = Q No error 
= 1 Error 


Global Descriptor Table requirements 


The GDT as described below defines the memory management environment 
that will be in effect upon return to the caller. 


The entry requirements are: 
» ES:SI points to a global descriptor table, which must be built before 
calling this function. 


«= The GDT entries are used by this function to initialize the interrupt descrip- 
tor table (IDT) register, the GDT register, and the stack segment (SS) 
selector. The data segment (DS) selector and the extra segment (ES) 
selector are initialized by the caller. 

= BH must contain an index into the IDT (interrupt descriptor table) to point 
to where the first eight hardware interrupts begin. 


« BL must contain an index into the IDT to point to where the second eight 
hardware interrupts begin. 


continued 
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Function: AH = 89h Switch Processor to Protected Mode, Continued 


Global Descriptor Table format 


The following table describes the information contained in the global 
descriptor table: 


| Offset | | 
from Table 
ES:SI | Entry # Description 
| 0 | 00h | 4 Words | Dummy. Must be initialized to 0 
Points to this GDT 


Points to caller-defined Interrupt Descriptor Table 


| 18h =| 4 Words | Points to caller’s data segment 
| 20h | 4 Words | Points to caller’s extra segment 


Points to caller’s stack segment 


| 4 Words | Points to code segment to which the function will return 


7 Used during this function to map BIOS code segment 


Note: The user-supplied GDT starting address must be in register ES:SI. 


GDT Processing 


All of the descriptors are initialized by the caller except the BIOS code 
segment descriptor. The access rights byte is set to O9Bh, the address to 
EQOOOh, and the data segment limit to FFFFh. The DS, ES, and SS selectors 
are loaded with 0081h, 0020h, and 0028h, respectively. 


CBIOS interrupt vectors are not written to operate in protected mode. For 
this reason a program that enters protected mode must construct its own 
IDT which does not overlap the CBIOS real mode table, and which handles all 
I/O interrupts while the program is in protected mode. 


Error conditions 


If not successful, the Carry Flag is set and AH is set to FFh. 


Reference 


For information about the descriptor definition, see function AH = 87h earlier 
in this chapter. 
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Functions: AH = 8Ah - 8Fh Reserved 


Function: AH = 90h Device Busy 


Description 


This function is used by multitasking operating systems. A multitasking 
operating system would point INT 15h to itself, intercept this function, and 
process the request as necessary. This would allow other tasks to be dis- 


patched while I/O is in progress. 


Input: 


Output: 


AH 
AL 


ES:BX 
CF 


90h 

Type code (hex), where: 
OOh Disk time-out 

Oth Diskette time-out 

O2h Keyboard 

03h Pointing device time-out 


= 21h Waiting for keyboard input 


80h Network. 
FCh Fixed disk reset time-out 


= FDh Diskette drive motor start 


INT 15h System Services 


FEh Printer time-out 


Points to a network control block (if AL = 80h) 


0 Wait time not satisfied 
1 Minimum wait time satisfied 
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Function: AH = 91th Interrupt Complete 


Description 


This function is used by multitasking operating systems. A multitasking 
operating system would point INT 15h to itself, intercept this function, and 
process the request as necessary. This would allow the operating system to 
be informed when I/O is done so the requesting task could be reactivated. 


Input: AH = 9th 

AL Type code, where: 
= OOh Disk time-out 
= Oth Diskette time-out 
= Q2h Keyboard 
= 03h Pointing device time-out 
= 80h Network 7 
= FCh Fixed disk reset time-out 
= FDh Diskette drive motor start 
= FEh Printer time-out 

ES:BX = Points to a network control block (if AL = 80h) 


Output: None 


Functions: AH = 92h -— BFh Reserved 
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Function: AH = COh Return System Configuration Parameters 


Description 


The Return Configuration Parameters function returns a pointer in ES:BX to 
the system configuration parameter table, located in ROM at FOOO:E6F5h, 
which gives information about the system. 


Input: AH = COh 
Output: AH = 0Oh Successful 
= 86h System model could not be determined 
CF = Q No error (AH = OOh) 


= 1 System model could not be determined (AH = 86h) 
ES:BX = Address of system configuration table 


System configuration table 


Initial | 
Offset value Length Description 


| 00h =| | Word Number of bytes in this table (minimum = 8) 


02h 1 Byte Model byte, where: 
Model 80 = F8h 
Model 70 = F8h 
Model 60 = FCh 
Model 50 = FCh 
| Model 30 = FAh 
Model 25 = FAh 
Unknown system board = FFh 


1 Byte Submodel byte, where: 
Model 80 = 00h or Oth 
Model 70 = 09h 
Model 60 = 05h 
Model 50 = 04h 
Model 30 = 00h 
Model 25 = Oth 
Unknown system board = FFh 


| on ft | 1 Byte BIOS revision level (first release = 00b) 


continued 
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Function: AH = CO0h Return System Configuration Parameters, 
Continued 


System configuration table, cont’d 


AH = 4Fh) called by keyboard interrupt 
service (INT 09h) 

Wait for external event supported 
Extended BIOS data area is allocated 
Micro Channel supported 


Initial 
value Length Description 
= 0 PC-type I/O channel implemented 


1 Byte Feature information byte, where: 
Bit 0 = 0 Reserved 


@ 
oe 
=o 
nou a 
ek eh, ooh 


Bit 7 = 1 Fixed disk BIOS uses DMA channel 3 
Bit 6 = 1 Second interrupt chip present 
Bit 5 = 1 Real time clock present 
Bit 4 = 1 Keyboard intercept (INT 15h, function 
4 Byte Feature information byte 2 (reserved, zeros) 
Feature information byte 3 (reserved, zeros) 
1 Byte Feature information byte 4 (reserved, zeros) 
1 Byte Feature information byte 5 (reserved, zeros) 


Determining model type: another method 
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The machine model type on which the BIOS is running can be determined by 
reading the system board ID from POS Register 0 (I/O Port 0100h) and POS 
Register 1 (I/O Port 0101h): 


= Model 50 = FBFFh 
= Model 60 = F7FFh 
= Model 80 = FEFFh 


CBIOS for IBM PS/2 Computers and Compatibles 


Function: AH = Cih Return Extended BIOS Data Area 
Segment Address 


Description 


This function returns the address of the data segment of the extended BIOS 
data area (EBDA) in ES. The extended BIOS data area address is at 40:0Eh. 


The BIOS uses the EBDA for transient data storage. For example, a program 
passes the address of a pointing device interface subroutine to the BIOS, 
which stores this address in its extended data area. 


The EBDA is allocated by the POST routines, which adjust the amount of free 
memory to allow for it. Refer to INT 12h to determine the amount of free 
memory available. 


Input: AH Cth 
Output: ES = Extended BIOS data area segment address 
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Function: AH = C2h Pointing Device Interface 


Introduction 


Function AH = C2h Pointing Device Interface contains a set of subfunctions 
designed to support pointing devices. Although the pointing device most 
commonly attached to a system is a mouse, any type of serial input device 
that is compatible with the Phoenix or IBM PS/2 8042 keyboard controller 
firmware can be used. 


For more information on IBM-—compatible 8042 controller firmware, please 
refer to Appendix B. 


Purpose of Pointing Device Interface subfunctions 


In general, the Pointing Device Interface subfunctions offer mouse driver 
software (or other pointing device software) a way to initialize, enable, 
disable, and reset the mouse, as well as control such device parameters as 
sample rate, resolution, and scaling factor. 


INT 74h ISR, function C2h, and data transmission 
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It is important to note that data package transmission from the pointing 
device to the system is not handled directly by Function C2h. Pointing device 
data transmission is handled mainly through INT 74h, the Interrupt Service 
Routine (ISR) associated with pointing devices. 


The flow of data from pointing devices to the system is as follows: 
» Pointing device transmits data package to 8042 chip. 

=» 8042 interrupts systems on IRQ 12. | 

» IRQ 12 is handled by INT 74h ISR. 


» INT 74h ISR collects data package, storing the information in the CBIOS 
Extended Data Area. 


«= INT 74h pushes pointing device data onto the stack and calls the pointing 
device’s device driver. 


= The address of the pointing device’s device driver must be stored in the 
CBIOS Extended Data Area by Function C2h, Subfunction 07h Device 
Driver Far Call Initialization. 


continued 
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Function: AH = C2h Pointing Device Interface, Continued 


Table of subfunctions 


There are several Pointing Device Interface subfunctions. The subfunctions 
are selected through either the AL register alone or through a combination of 


both the AL and BH registers. 
as Enable/Disable pointing device 


eset potting cence 


Ee Pointing device interface initialization 


Device driver far call initialization 
Error codes 


The error status of each Pointing Device Interface subfunction is returned in 
the AH register. When an error condition occurs, the Carry Flag is set and 
control is returned to the caller. 


Description 


No error 
Invalid function call 


No far call installed 


continued 


INT 15h System Services 387 


Function: AH = C2h Pointing Device Interface, Continued 


Subfunction: AL = 00h Enable/Disable pointing device 


This subfunction either enables a pointing device to allow the device to be 
used, or disables the device so it can no longer be used until re-enabled. 


Input: AH = C2h 


AL = OOh 
BH = OOh Disable 
= Qth Enable 


Output: AH = OOh No error 


= Oth Invalid function 

= 03h Interface error 

= 04h Reset 

= (05h No far call installed 
CF = ONO error 
1 Error 


Subfunction: AL = 01h Reset pointing device 
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This subfunction resets a pointing device, and stores the device ID in BH and 
the initial byte transmitted from the pointing device in BL. The Pointing De- 
vice Flag (40:28h) is cleared before this function terminates. 


If this subfunction completes successfully, the pointing device state will be: 


disabled, 

the sample rate will be 100 reports per second, 
the resolution will be 4 counts per millimeter. 
the scaling will be 1:1, and | 

the data package size will be the same. 


Input: AH = C2h 


AL = Oth 


Output: AH = OOh No error 


= OQ3h Interface error 


= 04h Resend 
BH = OOh Device ID 
BL = First byte of device response 
CF = OQNo error 

= 1 Error 


continued 
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Function: AH = C2h Pointing Device Interface, Continued 


Subfunction: AL = 02h Set sample rate 


This subfunction establishes a sample rate for the auxiliary device. If the 
sample rate is out of range, an invalid input condition (AH = 02h) is set and 
the subfunction is terminated. The rate sent to the device is derived from 
the value in BH, as defined in the following table: 


BH Input Value Reports per Second Sent to Auxiliary Device 


a 


50h = 80 reports/second 
— 64h = 100 reports/second 


C8h = 200 reports/second 


Input/Output 
Input: AH = C2h 
AL = Q2h 
BH = Sample rate value (OOh to 06h) 


Output: AH = OOh No error 
= Q2h Invalid input 
= 03h Interface error 
= 04h Resend 
CF = ONo error 
= 1 Error 


continued 
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Function: AH = C2h Pointing Device Interface, Continued 


Subfunction: AL = 03h Set resolution 


This subfunction sets the resolution of the auxiliary device. If the resolution is 
out of range, this subfunction terminates and sets an invalid input indicator. 


Input: AH 
AL 
BH 
Output: AH 
CF 


C2h 

03h 

Resolution value (OOh to 03h counts per millimeter) , 
where: 

OOh = 1 count/millimeter 

O1h = 2 counts/millimeter 

02h = 4 counts/millimeter 

O3h = 8 counts/millimeter 


OOh No error 

02h Invalid input 
O3h Interface error 
04h Resend 

O No error 

1 Error 


Subfunction: AL = 04h Read device type 
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This subfunction reads a byte from the auxiliary device and stores it in BH. If 
the first byte from the auxiliary device is not an Acknowledge, the device is 
re-enabled and a Resend condition is set. 


Input: AH 
AL 
Output: AH 
BH 
CF 


C2h 
04h 


OOh No error 

03h Interface error 
04h Resend 

OOh Device ID 

0 No error 

1 Error 


continued 
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Function: AH = C2h Pointing Device Interface, Continued 


Subfunction: AL = 05h Pointing device interface initialization 


This subfunction initializes the auxiliary device. If the data package size is out 
of range, this subfunction stops and sets CF on and AH to O2h. 


The auxiliary device reset is attempted three times. If all attempts fail, the 
data package size bits are reset, AH is set to 03h, and CF is set. 


If this subfunction completes normally, the pointing device state is: 
= disabled, 

=» the sample rate will be 100 reports/second, 

» the resolution will be 4 counts/millimeter, and 

= the scaling will be 1:1. 


Input: AH = C2h 
AL = O5h 
BH = Data package size (01h-08h, in bytes) 


Output: AH = OOh No error 
= 02h Invalid input 
= O3h interface error 
= 04h Resend 
CF = QNo error 
= 1 Error 


Subfunction: AL = 06h Extended commands 


This subfunction jumps to a subfunction based on the value in BH. If BH 
is out of range, this subfunction terminates and sets an invalid subfunc-— 
tion indicator. 


Input: AH = C2h 
AL = OQ6h 
BH = OOh Return status 
= Qith Set scaling factor to 1 
= Q2h Set scaling factor to 2 
Output: AH = OQOh No error 
= Q1h Invalid subfunction 
CF = OQNo error 
= 1 Error 


ol 
w_ 8 oh 


continued 
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Function: AH = C2h Pointing Device Interface, Continued 


Subfunction: AL = 06h BH = 00h Return status 


This subfunction reads and returns the status of the auxiliary device. The 
device sends three status bytes that are stored in registers BL, CL, and DL. 


Input! AH = C2h 
AL = O6h 
BH = OOh 
Output: AH = OOh No error 
= 03h Interface error 
= 04h Resend 
BL = Status byte 1, where: 
Bit 7 = 0 Reserved 


Bit 6 = 0 Stream mode 
= 1 Remote mode 
Bit 5 = 0 Disable 
= 1 Enable 
Bit 4 = 0 1:1 scaling 
= 1 2:1 scaling 
Bit 3 = 0 Reserved 
Bit 2 = 1 Left button pressed 
Bit 1 = 0 Reserved 
Bit O = 1 Right button pressed 
CF = ONo error 
= 1 Error 
CL = Status byte 2, where: 
OOh = 1 count per millimeter 
Oih = 2 counts per millimeter 
O2h = 4 counts per millimeter 
O3h = 8 counts per millimeter 
DL = Status byte 3, where: 


OAh = 10 reports per second 
14h = 20 reports per second 
28h = 40 reports per second 
3Ch = 60 reports per second 


50h = 80 reports per second 
64h = 100 reports per second 
C8h = 200 reports per second 


continued 


392 CBIOS for IBM PS/2 Computers and Compatibles 


Function: AH = C2h Pointing Device Interface, Continued 


Subfunction: AL = 06h BH = Oth Set scaling factor to 1:1 


Input: AH = C2h 
AL O6h 
BH = Oth 


Output: AH = OOh No error 
= 03h Interface error 
= 04h Resend 
CF = Q No error 
= 1 Error 


Subfunction: AL = 06h BH = 02h Set scaling factor to 2:1 


Input: AH = C2h 
AL = O6h 
BH = O2h 


Output: AH = OOh No error 
= 03h Interface error 
= Q4h Resend 
CF = QNOo error 
= 1 Error 


Subfunction: AL = 07h Device driver far call initialization 


This subfunction stores the device driver segment address in the CBIOS data 
area at 22h and the device driver offset address at 24h so that the device 
may be accessed. 


There must be a routine that receives control when the pointing device data 
is available. The device driver far call initialization gives the address of this 
routine to the CBIOS. Whenever pointing device data is available, the point- 
ing device interrupt handler calls the routine, with the following arguments 
on the stack: 

Status — First word on the stack 

X data — Second word 


Y data — Third word 
2 data — Fourth word on the stack 


continued 
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Function: AH = C2h Pointing Device Interface, Continued 


Subfunction: AL = 07h Device driver far call initialization, cont’d 
These words will be in the following format: 


Bit 


= 1 Y data overflow 
= 1 X data overflow 
= 1 Negative Y data sign 
= 1 Negative X data sign 
= 1 Reserved (must be 1) 
= 0 Reserved (must be 0) 
= 1 Right button pressed 
= 1 Left button pressed 


HH 
fe} 
> 

oA NO fh OO N 


= X data — most significant bit 
= X data — least significant bit 


= Y data — most significant bit 
= Y data — least significant bit 


0 
a 


When transferring control to the user routine, the pointing device interrupt 
handler uses a far call. The user routine should be coded as a far procedure 
and should not move the parameters off the stack before returning. 


Input: AH = C2h 

AL = 07h 

ES:BX = Device drive segment and offset address. 
Output: AH OOh No error 
Error status (40:41h) 
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Function: AH = C3h Watchdog Time-Out 


Description 


The watchdog time-out function has two subfunctions: enable and disable. 
The watchdog timer ensures that a program does not turn interrupts off for 
too long a period. If interrupts are turned off for too long, the timer interrupt 
may not be serviced. 


The watchdog time-out decrements each timer tick that the timer interrupt is 
not serviced. At the end of the watchdog period, an NMI is generated. POST 
disables the watchdog timer. The user must enable it. 


Models 25 and 30: This function is not available on IBM PS/2 Models 25 and 
30 (and compatibles). 


Error conditions 


lf the subfunction code is not valid, one is subtracted from AL, CF is set to 
One, and control is returned to the caller. 


Subfunction: AL = 00h Disable watchdog time-out 
This subfunction disables the watchdog timer. 


Input: AH = C3h 


AL = OOh 
Output: CF = O No error 
= 1 Error 


Subfunction: AL = 01h Enable watchdog time-out 


This subfunction enables the watchdog time-out with the time-out timer tick 
count (from 1-255) in BX. 


Input: AH = C3h 

AL = Oth 

BX Watchdog timer count (1-255) 
Output: CF = ONo error 
1 Timer count is out of range 
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Function: AH = C4h Programmable Option Select 


Description 


This function allows the caller to access the Programmable Option Select 
(POS) features of the system’s adapter cards. Three subfunctions are pro- 
vided and are selected through the AL register: return base address, enable 
channel for setup, and enable adapter. 


Models 25 and 30: This function is not available on IBM PS/2 Models 25 and 


30 (and compatibles). 


Subfunction: AL = 00h Return base POS adapter register address 


Input: AH 
AL 
Output: CF 
DX 


C4h 

OOh 

O No Error 

1 Error 

Base POS adapter register address 


Subfunction: AL = 01h Enable channel for setup 


This subfunction enables the channel specified in BL. Channel numbers must 
be between 1 and 8, if not, CF is set and control is returned to the caller. 
Channel numbers for specific models are not checked. This subfunction 
does not modify any registers. 


Input: AH 
AL 
BL 
Output: CF 
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C4h 

Oth 

Channel number (1-8) 

O No error 

1 Invalid channel number 


continued 
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Function: AH = C4h Programmable Option Select, Continued 


Subfunction: AL = 02h Adapter enable 


This subfunction disables the setup for all channels, thus enabling the adapt- 
ers on those channels. 


Input: AH 
AL 
Output: CF 


C4h 
02h 


O No Error 
1 Error 


Functions: AH = C5h —- FFh Reserved 
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Chapter 14 
INT 17h Parallel Printer Service 


Overview 


Description 


The CBIOS Parallel Printer Service provides BlIOS-level support for up to 
three parallel printer ports. 


How the Parallel Printer Service is invoked 
Software INT 17h invokes the CBIOS Parallel Printer Service. 


The INT 14h vector resides at address 005Ch in the Interrupt Vector Table. 
The CBIOS initializes the INT 17h vector to FOO0:EFD2h, the IBM-compatible 
entry point. 


continued 
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Overview, Continued 


Summary of Parallel Printer Service functions 


The CBIOS Parallel Printer Service contains three functions. Individual func- 
tions are selected via the AH register. 


Description 


In this chapter 


This chapter focuses on the INT 17h Parallel Printer Service. The following 
topics are discussed: 

» Hardware Environment 

= Parallel Port I/O Addresses 

» System RAM Data 

» Error Handling 

# Parallel Printer Service Functions 
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Hardware Environment 


Parallel printer ports assumed 


The CBIOS Parallel Printer Service assumes three parallel printer ports. 


Parallel Port 1/O Addresses 


The characteristics of each printer port are defined in the following table. 


Read/Write 
1/O Address Status Description 


0278h Parallel 3 data port 


0279h R/W Parallel 3, status port, where: 
Bit 7 = 0 Busy 
Bit 6 = 0 Acknowledge 
: | Bit § = 1 Out of paper 
Bit 4 = 1 Printer is selected 
Bit 3 = 0 Error 
Bit 2 = 0 IRQ has occurred 
Bits 1-0 = Reserved 
027Ah 
0 
Bit 1 1 Automatic line feed 
Bit 0 1 Strobe 


R/W 
0378h Parallel 2 data port 


0379h R/W Parallel 2, status port, where: 


Bit 7 = 0 Busy 

Bit 6 0 Acknowledge 

Bit 5 1 Out of paper 

1 Printer is selected 
Error 


Parallel 3, control port, where: 


Bits 7-6 = Reserved 
Bit 5 = 0 Direction is write to port 
= 1 Direction is read from port 


Bit 4 = 1 Enable IRQ 
Bit 3 1 Select printer 
Bit 2 Initialize printer 


Bit 4 
Bit 3 
Bit 2 = 0 IRQ has occurred 
Bits 1-0 = Reserved 


continued 
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Parallel Port I/O Addresses, Continued 


402 


Read/Write 
1/0 Address Status | Description 


Parallel 2, control port, where: 
Bits 7-6 = Reserved 


Bit 5 = 0 Direction is write to port 
= 1 Direction is read from port 
Bit 4 = 1 Enable IRQ 
Bit 3 = 1 Select printer 
Bit 2 = 0 Initialize printer 
Bit 1 = 1 Automatic line feed 


Bit 0 a Strobe 


Parallel 1, status port, where: 


Bit 7 = 0 Busy 

Bit 6 = 0 Acknowledge 

Bit 5 = 1 Out of paper 

Bit 4 = 1 Printer is selected 
Bit 3 = a. Error 


Bit 2 


Parallel 1, control port, where: 
Bits 7-6 = Reserved 


Bit 5 = 0 Direction is write to port 
= 1 Direction is read from port 
Bit 4 = 1 Enable IRQ 
Bit3 =1 Select printer 
Bit 2 = 0 Initialize printer 
a MB = 1 Automatic line feed 
t = 


1 Strobe 
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System RAM Data 


Introduction 


The CBIOS Parallel Printer Service makes use of information located in the 
BIOS Data Area of system RAM (address 40:00h through 40:100h). The table 
below describes the BIOS Data Area definitions referred to by the Printer 
Device Service. 


| osh =| words | 1/O address of up to 3 printer adapters. 


1 word Number of devices installed, where: 

Bits 15-14 = Number of printer adapters 

Bits 13-12 = Reserved 

Bits 11-9 = Number of asynchronous adapters 
(RS232) 

Bits 8 = Reserved 

Bits 7-6 = Number of diskette drives, where: 
00b = 1 diskette drive 
Oib = 2 diskette drives 

Bits 5-4 = Initial video mode, where: 
00b = EGA/VGA or PGA 
01b = 40x25 color 
10b = 80x25 color 
11b = 80x25 black and white 

Bit 3 = Reserved 

Bit 2 = Pointing device 

Bit 1 = 1 If math coprocessor 

Bit O = Diskette available for boot 


78h 3 bytes One byte per adapter. Time-—out values for printer 
number 1 through 3. 
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Error Handling 


Before entering any functions, this service ensures that the DX index is not 
out of range, that the function number is not out of range, and that the 
printer is at the specified index. There are only three printer ports. 


lf any of the above conditions are not met, the service returns to the caller 
with all registers restored except AH. When DX is out of range or the printer 
does not exist, AX is not modified. When the function number is out of 
range, AH is returned, and is decremented by 2. 


Function: AH = 00h Print Character 


Description 


The Print Character function prints the character in the AL register to the 
printer specified in the DX register. The printer status is returned in the AH 


register. 
Input/Output 
Input: AL = Character to print 
DX = Printer number (0 = LPT1, 1 = LPT2, or 2 = LPT3) used as 
an index to the printer base port address table at 40:08h. 
Output: AH = Printer status, where: 
Bit 7 = 1 Printer not busy 
Bit 6 = 1 Acknowledgment 
Bit 5 1 Out of paper 
Bit 4 = 1 Printer selected 
Bit 3 = 11/0 error 
Bit 2 = Reserved 
Bit 1 Reserved 
Bit O = 1 Time-—out 
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Function: AH = 01h Initialize Printer 


Description 


The Initialize Printer function initializes the printer selected in the DX register. 
The printer status is returned in register AH. 


Input/Output 
Input: DX 


Printer number (O = LPT1, 1 = LPT2, or 2 = LPT3) used as 


an index to the printer base port address table at 40:08h. 


Output: AH 


Bit 7 
Bit 6 
Bit 5 
Bit 4 
Bit 3 
Bit 2 
Bit 1 
Bit 0 
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Printer status, where: 


1 Printer not busy 

1 Acknowledgment from printer 
1 Out of paper 

1 Printer selected 

1 1/O error 

Reserved 

Reserved 

1 Time-out error 
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Function: AH = 02h Read Printer Status 


Description 


The Read Printer Status function reads and returns the status of the printer 


selected by the DX register. 


Input/Output 


Input: DX = Printer number (0 = LPT1, 1 = LPT2, or 2 = LPT3) used as 
an index to the printer base port address table at 40:08h. 


Output: AH 


Bit 7 
Bit 6 
Bit 5 
Bit 4 
Bit 3 
Bit 2 
Bit 1 
Bit O 


Printer status, where: 


1 Printer not busy 

1 Acknowledgment from printer 
1 Out of paper 

1 Printer selected 

1 I/O error 

Reserved 

Reserved 

1 Time-out error 


Functions: AH = 03h - FFh Reserved 
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Chapter 15 
INT 1Ah Time-of-—Day Service 


Overview 


Introduction 


The CBIOS provides the following timer—-related support: 


= INT 1Ah Time-of-Day Service 
Software INT 1Ah invokes the CBIOS Time-of-—Day Service. The Time- 
of-Day Service provides CBIOS users with 12 system time and date 
functions. 


w INT 08h System Timer ISR 
The Intel 82284 clock generator chip, or its equivalent, “ticks” roughly 
18.2 times per second. Each tick generates hardware INT 08h, System 
Timer Interrupt. 


The CBIOS System Timer routine increments the system time count, then 
invokes software INT 1Ch. CBIOS users may revector INT 1Ch to their own 
routines. If not revectored, INT 1Ch returns immediately to the caller with 
all registers preserved. 


continued 
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Overview, Continued 


Introduction, cont’d 


= INT 70h Real Time Clock ISR 
The Motorola MC146818A real time clock chip, or its equivalent, gener- 
ates a hardware interrupt approximately 1024 times per second. 


The CBIOS Services contain three functions that determine how the CBIOS 


Real Time clock hardware ISR will handle interrupts from the Real Time 
clock chip. 


CBIOS Function Effects on CBIOS RTC ISR 


INT 15h: AH = 83h Event Wait Interval 
INT 15h: AH = 86h Wait 


INT 1Ah: AH = 06h Set User Alarm 


These functions activate the CBIOS Real Time 
Clock ISR’s Periodic Interrupt component. 


This function activates the CBIOS real time 


clock ISR’s Alarm Interrupt component. 


In this chapter 
This chapter discusses each of the CBIOS timer-related services. The follow- 
ing topics are presented: 
» INT 1Ah Time-of-Day Service 
» INT 08h System Timer ISR 
» INT 70h Real Time Clock ISR 
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INT 1Ah Time-of-Day Service 


Introduction 
The CBIOS Time-of—Day service provides 12 system time-related functions. 


How the CBIOS Time-of-—Day service is invoked 


The CBIOS Time-of-Day service is invoked via software interrupt INT 1Ah. 
Individual Time-of-—Day functions are selected via the AH register. Subfunc- 
tions are selected via the AL register. 


The INT 1Ah vector resides at address 00:68h in the Interrupt Vector Table. 
The CBIOS initializes the INT 1Ah vector to address FOOO:FE6Eh, the IBM- 
compatible entry point. 


Summary of Time-of-Day service functions 
The following table lists the Time—-of—Day functions. 


Functions Description 


=) 


Oh Read System Timer Time Counter 
Set System Timer Time Cointee 
Read Real Time Clock Time 

Set Real Time Clock Time 

Read Real Time Clock Date 

05h . | Set Real Time Clock Date 


O6h Set Real Time Clock Alarm 


=) 


7h Reset Real Time Clock Alarm 

Set Real Time Clock Activated Power-On Mode 
Read Real Time Clock Alarm Time and Status* 
OAh Read System Timer Day Counter 


Set System Timer Day Counter 


OCh — FFh Reserved 
. For IBM PS/2 Models 25 and 30 only 


1?) 
O 
a | 
= 
~ 
© 
Qo. 
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INT 1Ah Time-of-Day Service, Continued 


Hardware Environment 


The CBIOS Time-of-Day Service routine assumes the existence of a CMOS 
real time clock that contains 64 bytes of nonvolatile RAM and is compatible 
with a Motorola MC146818A chip. Also, the Intel 82284 clock generator chip, 
or its equivalent, is assumed. 


Time-of-—Day Service I/O Ports 


INT 1Ah, Time-of-Day Service, references the following I/O ports: 
Bit 7 = 1 NMI disable 
0071h a CMOS RAM data register port 
Bit 6 = 0 Enable fixed disk interrupt 
Bit 3 = 0 Reserved 


Read/Write 
1/O Address Status Description 
= 0 NMI enabled 
0OAth _ Programmable Interrupt Controller 2 mask, where: 
Bit 5 = 0 Enable 80387 exception interrupt 


0070h WwW CMOS RAM address register port, where: 
| Bits 6-O= 0 CMOS address 
Bit 7 = 0 Reserved 
Bit 4 = 0 Enable mouse interrupt 
System RAM data 


Bit 2 = 0 Reserved 
Bit 1 = 0 Enable redirect cascade 
Bit 0 = 0 Enable real time clock interrupt 


The following table lists all system RAM data areas, beginning at segment 
40h, used by the Time-of-Day service. 


40:6Ch Least significant timer ‘tick’ count 
40:6Eh Most significant timer ‘tick’ count 
40:70h 24 hour rollover flag 


40:CEh Count of days since 1/1/80 | 


continued 


410 CBIOS for IBM PS/2 Computers and Compatibles 


INT 1Ah Time-of-Day Service, Continued 


CMOS RAM Data 


The following table presents the CMOS RAM data areas used by the Time- 
of-—Day service routine. 


(oor _[ tare | current sesondin nary coded! decinal (800) 
[an [ tae | Curent mine 
[oa | te | Minute larminscO 
Se 
| oh 
0m 
om 
oo 
a 


Status Register A, where: 


Bit 7 = 1 Update in progress 
Bits 6-4 = Divider that identifies the time-based 
frequency 


Bits 3-0 = Rate-selection bits that define output 
frequency and periodic interrupt rate 


Status Register B, where: 


Bit 7 = 0 Run 
= 1 Halt 
Bit 6 = 1 Enable periodic interrupt 
Bit 5 = 1 Enable alarm interrupt 
Bit 4 = 1 Enable update-ended interrupt 
Bit 3 = 1 Enable square wave interrupt 
Bit 2 = 1 Calendar is in binary format 
= 0 Calendar is in BCD format 
Bit 1 = 1 24-hour mode 
= 0 12-hour mode 
Bit 0 = 1 Enable Daylight Savings Time 


Status register C, where: 


Bits 7-4 = IRQF, PF, AF, and UF flags, 
respectively 
Bits 3-0 = Reserved 


Status register D, where: 


Bit 7 = 1 Real time clock has power 
Bits 6-O = Reserved 


continued 
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INT 1Ah Time-of-Day Service, Continued 


Time-of—Day Error Handiing 


The CBIOS Time-of-—Day service generates one error that is applicable to all 
functions of this service. The Carry Flag is set if an invalid function is re- 
quested. The function number is stored in AH if there is an invalid function 
request. . 


Otherwise, each function handles all other errors uniquely. Refer to the 
description for each function for specific information about error codes. 


Function: AH = 00h Read System Timer Time Counter 


412 


The Read System Timer Time Counter function reads and returns the system 
tick count from the system RAM location 40:6Eh (high word) and 40:6Ch 
(low word). 


The values stored in these locations are defined by the frequency of the 
timer interrupt, which is approximately 18.2 ticks per second. The AL regis- 
ter will be O if the timer has not exceeded 24 hours. Otherwise, RAM data 
area location 40:70h has the same value that the AL register has. 


Interrupts are disabled while reading RAM data memory locations because a 
timer tick update may occur. 


Execution of this function causes the Timer Overflow Flag at 40:70h to be 
reset to 0. 


Input: AH = OOh 


Output: AH = OOh 
AL = Timer overflow value, where: 
= Q Timer count is less than 24 hours since the last 

power-on or system reset. Any value greater than 0 Timer 
count is more than 24 hours since last power-on, system 
reset, last system-timer time counter read, or last 
system-timer time counter set. 

CF = ONo error 


= 1 Error 
CX = High word of tick count 
DX = Low word of tick count 


continued 
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INT 1Ah Time-of-Day Service, Continued 


Function: AH = 01h Set System Timer Time Counter 
The Set system timer time counter function stores values from CX and DX 
to RAM data areas 40:6Eh (high word) and 40:6Ch (low word). 
Execution of this function causes the Timer Overflow Flag at 40:70h to be 
reset to 0. 


Input: AH = Oth 
CX = High word of tick count 


DX = Low word of tick count 
Output: AH = OOh 
CF = OQ No error 
1 Error 


Function: AH = 02h Read Real Time Clock Time 


This function first finds out if the CMOS RAM is currently updating its clock 
value. 


lf an update is not in progress, the appropriate values are taken from CMOS 
RAM and returned to the caller, with the Carry Flag cleared and AH = OOh. 


Input/Output 

Input: AH = OQ2h 

Output: AH = OQOh 
AL = Same as CH 
CF = O Clock operating 

= 1 Clock not operating 
CH = Hours in BCD 
CL = Minutes in BCD 
DH = Seconds in BCD 
DL = OOh — No Daylight Savings Time option 
Oih — Daylight Savings Time option 


Error conditions 


lf a time-out occurs, which indicates an update is in progress, CF is set to 
one, AH is cleared, and control is returned to the caller. 


continued 
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INT 1Ah Time-of-Day Service, Continued 


Function: AH = 03h Set Real Time Clock Time 


This function first finds out if the CMOS RAM is Currently updating its clock 
value. If an update is in progress, the real time clock is initialized. 


The values defined in the input section are stored in their respective CMOS 
RAM storage locations. Hours are stored in CMOS RAM location 04h, minutes 
in location 02h, and seconds in location OOh. 


Input/Output 


Input: AH 
CH 
CL 
DH 
DL 


Output: AH 
| AL 
CF 


Error conditions 


O3h 

Hours in BCD 

Minutes in BCD. 

Seconds in BCD 

OOh No DST option 

Oih DST option 

OOh 

Value written to CMOS OBh register 
O No error | 

1 Error 


If a time-out occurs, which indicates that an update is in progress, the clock 
is initialized and the routine continues as if an update were not in progress. 
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continued 
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INT 1Ah Time-of-Day Service, Continued 


Function: AH = 04h Read Real Time Clock Date 
This function first finds out if the CMOS RAM is currently updating its clock 
value. 


If no time-out occurs, the century, year, month, and day are extracted from 
CMOS RAM and are returned to the caller as described in the output section. 
Upon return, the Carry Flag is cleared and AH = OOh. 


Input/Output 
Input: AH = O4h 
Output: AH = OOh 


CF = QNo error 
= 1 Clock update in progress 
CH = Century in BCD (either 19 or 20) 
CL = Year in BCD 
DH = Month in BCD 
DL = Day in BCD 


Error conditions 


If a time-out occurs, which indicates that an update is in progress, the Carry 
Flag is set, AH is cleared, and control is returned to the caller. 


continued 
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INT 1Ah Time-of-Day Service, Continued 


Function: AH = 05h Set Real Time Clock Date 
This function first finds out if the CMOS RAM is currently updating its clock 


value. 


The values defined in the input section are stored in their respective CMOS 
RAM storage locations. Century is stored in location 37h, year in OSh, month 
in location 08h, and day in location O6h. This function then returns to the 
caller with the Carry Flag cleared and AH = OOh. 


Input/Output 


Input: AH 
CH 
CL 
DH 
DL 


Output: AH 
AL 
CF 


Error conditions 


416 


O5h 

Century in BCD (either 19 or 20) 
Year in BCD 

Month in BCD 

Day in BCD 

OOh 

Value written to CMOS OBh register 
O No error 

1 Error 


If a time-out occurs, which indicates that an update is in progress, the clock 


is initialized. 


continued 
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INT 1Ah Time-of-Day Service, Continued 


Function: AH = 06h Set Real Time Clock Alarm 


This function first tests if an alarm is in progress. If an alarm is in progress, 
control is returned to the caller with the Carry Flag set and AH cleared. 


lf an alarm is currently not enabled, this test finds out if the CMOS RAM is 
updating its clock value. !f a time-out occurs, which indicates that an update 
is in progress, the clock is initialized. This function then sets the alarm with 
the values from registers CH, CL and DH. 


The alarm interrupt will take place at the hour, minute, and second specified 
in registers CH, CL, and DH, respectively. You can only have one alarm 
function in an active state at any one time. The alarm interrupt, Once set, 
will be activated every 24 hours until reset. 


The values defined in the input section are stored in their respective CMOS 
RAM storage locations. 


Note: This function clears AX, not just AH. 


Input/Output 


Input: AH = O6h 

CH = Hours in BCD 

CL = Minutes in BCD 

DH = Seconds in BCD 
Output: AH = OOh 

AL = OOh 

CF = ONO error 
1 Alarm already set 


Error conditions 


CF is set to one if an alarm has already been set. 


continued 
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INT 1Ah Time-of-Day Service, Continued 


Function: AH = 07h Reset Real Time Clock Alarm 
This function stops the real time clock alarm interrupt. 


Input: AH = OQ7h 


Output: AH = OOh 
CF = QNo error 
= 1 Error 


Function: AH = 09h Read Real Time Clock Alarm and Status 
This function reads the real time clock alarm’s time and status. 


Models 25 and 30: This function applies only to PS/2 Models 25 and 30. 
Other PS/2 models will return CF = 1, invalid function 
request. 


Input: AH = O9h 


Output: CH = Hours in BCD 
CL = Minutes in BCD 
DH = Seconds in BCD 
DL = Alarm status 
OOh = Alarm is not installed 


Function: AH = 0Ah Read System Timer Day Counter 


The Read System Timer Day Counter function reads the count of days since 
1/1/80 from the System RAM data area 40:CEh, and returns it to the caller 
in the CX register. | 


Models 25 and 30: On the IBM PS/2 Models 25 and 30, POST initializes the 
count of days since 1/1/80 to zero. 
Input: AH = OAh 


Output: AH = OOh 
CF = ONo error 
= 1 Error 
CX = Count of days since 1/1/80 


continued 
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INT 1Ah Time-of-Day Service, Continued 


Function: AH = OBh Set System Timer Day Counter 


The Set System Timer Day Counter function sets the count of days since 
1/1/80 in the ROM BIOS data field 40:CEh from the parameter passed in the 
CX register. 


Models 25 and 30: On the IBM PS/2 Models 25 and 30 (and compatibles) , 
POST initializes the count of days since 1/1/80 to zero. 


Input: AH = OBh 
CX = Count of days since 1/1/80 
Output: AH = OOh 


CF = ONO error 
1 Error 


AH = 0Ch to FFh Reserved 
Functions AH = OCh to FFh are reserved. 
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INT 08h System Timer ISR 


Description 


The Intel 82284 clock generator chip, or its equivalent, “ticks” roughly 18.2 
times per second. Each tick generates hardware INT O8h, System Timer 
Interrupt. 


The CBIOS System Timer routine increments the double word, system time 
count. The system time count is stored in the CBIOS system RAM data area 
at locations 40:6Ch (low word) and 40:6Eh (high word). 


If the count in these location exceeds 24 hours, then the contents of location 
40:70h is set to 1 and the date is incremented. When 40:70h is set, the 
system time count (40:6Ch and 40:6Eh) is cleared. 


Diskette motor count 


The processing of INT O8h includes the decrement of the diskette motor 


counts at 40:35h. If the count reaches zero, the diskette motors are turned 
off. 


INT 1Ch 


Once it has serviced the clock, INT 08h issues a software INT 1Ch. CBIOS 
users may revector INT 1Ch to their own routines. 


If not revectored, INT 1Ch returns immediately to the caller with all registers 
preserved. 


How CBIOS System-Timer ISR is invoked 


The CBIOS System-Timer hardware interrupt service routine is invoked via 
hardware INT Q8h. 


The INT 08h vector resides at address 00:20h in the Interrupt Vector Table. 
The CBIOS initializes the INT O8h vector to FOOO:FEA5h, the IBM—compatible 
entry point. 


continued 
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INT 08h System Timer ISR, Continued 


System RAM data 
The CBIOS system timer ISR references the following system RAM data: 


[~wooen | tone | exendoa 6105 cataarea 
[a040n [1 8ne | Dikate motor tne-out count 


e 


Extended BIOS data area 


The CBIOS system timer ISR references the following item in the CBIOS 
extended data area: 


EDA:35h 1 Byte Watchdog timer initial count 
Note: EDA = Extended Data Area segment 
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Hardware Environment 


The CBIOS System Timer routine assumes the existence of a CMOS real 
time clock with 64 bytes of nonvolatile RAM, compatible with a Motorola 
MC146818A chip. Also, the Intel 82284 clock generator chip or its equivalent 
is assumed. 


continued 
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INT 08h System Timer ISR, Continued 


System Timer I/O Ports 
INT O8h, System Timer ISR, references the following !/O ports: 


Read/Write 
1/O Address Status Description 


ae ae Base port of 8259 interrupt 
0040h —— Fw Read/write counter 0 
WwW 


Read/write counter 2 


Control word register for counters 0 and 2, where: 


Bits 7-6 = 00b Select counter 0 
= 01b Reserved 
= 10b Select counter 2 

Bits 5-4 = 00b Counter latch command 
= 01b Read/write counter bits 0-7 only 
= 10b Read/write counter bits 8-15 only 
= 11b Read/write counter bits 0-7 first, 

then bits 8-15 

Bits 3-0 = 000b Mode 0 select 
= 001b Mode 1 select 

= X10b Mode 2 select 

X11b Mode 3 select 

100b Mode 4 select 

101b Mode 5 select 

0 Binary counter 16 bits 

1 Binary coded decimal counter 


| 0044h | ww Read/write counter 3 


0047h Control word register for counter 3, where: 


Bit 0 


Bits 7-6 = 00b Select counter 3 

= 01b Reserved 

= 10b Reserved 

= 11b Reserved 

Bits 5-4 = 00b Counter latch command select 
counter 0 


Bits 3-0 = 00b 


System control port B | 


Diskette controller digital output register, where: 


Bit 7-6 = 0 Reserved 
Bit 5 = 1 Motor enable 1 


(2) 
(o>) 
oO) 
a_i, 
i 


Bit 4 = 1 Motor enable 0 
Bit 3. =0 Allow interrupts 
Bit 2 =0O Controller reset 
Bit 1 =0 Reserved 

BitO = 


0 Drive select 0 
1 Drive select 1 
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INT 70h Real Time Clock ISR 


Introduction 


The Motorola MC146818A real time clock chip, or its equivalent, generates a 
hardware interrupt approximately 1024 times per second. The CBIOS real 
time clock hardware interrupt service routine (ISR) is invoked on each real 
time clock interrupt. 


How the real time clock ISR is invoked 
The CBIOS real time clock ISR is invoked via hardware interrupt INT 7Oh. 


The INT 70h vector resides at address 00:1Ch in the Interrupt Vector Table. 
The CBIOS initializes the INT 70h vector to address F000:5124h, the IBM- 
compatible entry point. 


Real Time clock ISR processing 


The CBIOS Services contain three functions that determine how the CBIOS 
Real Time clock hardware |!SR will handle interrupts from the Real Time clock 
chip. 


CBIOS Function Effects on Real Time Clock Processing 


INT 15h: AH = 83h Event Wait Interval PERIODIC INTERRUPT PROCESSING 


INT 15h: AH = 86h Walt The CBIOS Real Time clock ISR decre- 
These functions activate the CBIOS ments a counter (set to a user-defined 
Real Time Clock ISR’s Periodic Inter- period of time) by 1/1024 second for each 
rupt component. RTC interrupt. 


When the count is less than or equal to 
zero, bit 7 of a user Wait flag is set. 


INT 1Ah: AH = 06h Set User Alarm ALARM INTERRUPT PROCESSING 


This function activates the CBIOS The CBIOS real time clock ISR decrements 
real time clock ISR’s Alarm Interrupt a counter (set to a user-specified period 
component. of time) by 1/1024 second for each RTC 
. interrupt. When the count reaches zero, 
the CBIOS real time clock ISR issues a 
software INT 4Ch. 


CBIOS users may revector INT 4Ch to 
their own routines. If not revectored, INT 
4Ch returns immediately to the caller with 
all registers preserved. 


continued 
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INT 70h Real Time Clock ISR, Continued 


Hardware Environment 


The CBIOS Real Time Clock Interrupt Service routine assumes the existence 
of a CMOS real time clock with 64 bytes of nonvolatile RAM, compatible with 
a Motorola MC146818A chip. Also, the Intel 82284 clock generator chip or its 
equivalent is assumed. 


System RAM data area 


The CBIOS real time clock ISR references the following system RAM data: 


dni 
INT 08h) 


40:9Ah User wait flag segment address 


40:9Ch Least significant wait count | 
40:9Eh Most significant wait count 


40:A0h 1 Byte 


Wait active flag, where: 


Bit7 =1 If wait time elapsed 

Bits 6-1= Reserved 

Bit 0 = 1 If INT 15h, AH = 86h (wait) 
has occurred 


continued 
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INT 70h Real Time Clock ISR, Continued 


Real Time Clock I/O Ports 
INT 70h, Real Time Clock ISR, references the following |/O ports: 


0070h WwW CMOS RAM address register port, where: 
Bits 6-O = 0 CMOS address 


Read/Write 
1/O Address Status Description 
Bit 7 = 1 NMI disable 
0071h R/W CMOS RAM data port 


0020h Master Programmable Interrupt Controller 
= 0 NMI enabled 
OOAOh R/W Slave Programmable Interrupt Controller 


CMOS RAM data table areas 
The CBIOS real time clock ISR references the following CMOS RAM data: 


Location Description 
OBh 1 Byte Status register B, where: 
Bit 7 = 0 Run 
= 1 Halt 
Bit 6 = 1 Enable periodic interrupt 
Bit 5 = 1 Enable alarm interrupt 
Bit 4 = 1 Enable update-ended interrupt 
Bit 3 = 1 Enable square wave interrupt 
Bit 2 = 1 Calendar is in binary format 
= Q Calendar is in BCD format 
Bit 1 = 1 24-hour mode 
= 0 12-hour mode 
Bit 0 = 1 Enable Daylight Savings Time 
OCh 1 Byte Status register C, where: 


Bits 7-4 = IRQF, PF, AF, and UF flags, 
respectively 


Bits 3-0 = Reserved 


1 Byte Status register D, where: 


Bit 7 = 1 Real time clock has power 
Bits 6-0 = Reserved 
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Chapter 16 
Single Function CBIOS Services 


Overview 


Introduction 


Most of the CBIOS device services contain a group of functions intended to 
service a given device. For example, in the CBIOS Parallel Printer service, 
invoking INT 17h with AH = OOh causes the service to execute its print 
character function. On the other hand, invoking INT 17h with AH = Oth 
causes the service to execute its Initialize Printer Port function. 


The single function services 


In addition to its multifunction device services, the CBIOS also contains four 
single function device services. Since these services perform only one 
function, it is not necessary to specify a function number in the AH register. 


continued 
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Overview, Continued 


In this chapter 


Because each single function service can be described on one or two 
pages, they are grouped into this one chapter. 

This chapter presents the following topics: 

= INT 05h Print Screen Service 

» INT 11h Equipment List Service 

» INT 12h Memory Size Service 

» INT 19h Bootstrap Loader Service 
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INT 05h Print Screen Service 


Description 
The Print Screen Service: 


= prints the contents of the entire current video screen to printer number O, 


»" moves the cursor across the screen as the lines on the screen are 
printed, 


=» repositions the cursor position to its original position, and 
= returns all registers to their original values. 


Since the Print Screen Service takes a considerable amount of time to 
execute, interrupts are enabled throughout the routine. 


How the service is invoked 
INT O5h invokes the CBIOS Print Screen Service. 
The INT O5h vector resides at the Interrupt Vector Table address 00:14h. The 


CBIOS initializes the INT 05h Print Screen Service vector to address 
FOOO:FF54h, the IBM-compatible BIOS entry point. 


Note: INT O5h is usually invoked by the keyboard interrupt handler (INT O9h) 
when the PrtSc key is pressed. However, CBIOS users may invoke INT 
O5h independently of the INT O9h interrupt handler. For more informa- 
tion on INT O9h, refer to Chapter 8 of this volume. 


System RAM Data 


The Print Screen Service uses two system RAM data definitions. Both defini- 
tions are located in the CBIOS Data Area (absolute hex address 400h to 
500h) and are defined in the table below: 


40:84h Number of rows on screen (24/25) 


40:100h 1 Byte | Print Screen Status Byte, where: 
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00h = Print Screen Service inactive, or Print 
Screen Service successful upon return 
Oih = Print Screen in progress 


FFh = Error occurred 


continued 


INT 05h Print Screen Service, Continued 


Input/Output 


Input: None 


Output: None (Registers are preserved) 


Error conditions 


430 


The Print Screen Service recognizes three kinds of error conditions. 


The table below summarizes the Print Screen Service error handling 


procedures. 


pe Then the Print Screen Service... 


the printer is busy 


the printer is out of paper 


recursive print screen 
requests are made 


Sets location 40:100h = FFh 
Repositions cursor to original position 
Preserves all registers 

Returns to the caller 


Repositions cursor to original position 
Preserves all registers 

Returns to the caller 

Sets location 40:100h = FFh 


Preserves all registers 

Returns to the caller 

Does not change location 40:100h (it was set to 
01 by previous INT 05h request) 
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INT 11h Equipment List Service 


Description 


The Equipment List Service returns the contents of system RAM location 
40:10h in the AX register. This memory location contains the system equip- 
ment list as determined by the CBIOS power-on self test and initialization 


(POST) routine. 


How the service is requested 


INT 11h requests the Equipment List Service of the CBIOS. 


The INT 11h vector resides at the Interrupt Vector Table address 0:44h. The 
CBIOS initializes the INT 11h Equipment List Service vector to address 
FOOO:F84Dh, the IBM-—compatible entry point. 


Input/Output 
Input: None 
Output: Equipment List 
AX = Contents of system RAM location 40:10h, where: 

Bits 15-14 = Number of printer adapters 

Bits 13-12 = Reserved | 

Bits 11-9 = Number of RS-232-C asynchronous adapters 

Bit 8 = Reserved 

Bits 7-4 = Number of diskette drives, (if Bit O = 1), 
where: 
OOb = 1 diskette drive 
O1b = 2 diskette drives 

Bit 5-4 = Initial video mode, where: 

| OOb = EGA or PGA 
O1b = 40x25 color 
10b = 80x25 color 
11b = 80x25 black and white 

Bit 3 = Reserved 

Bit 2 = 1 If pointing device installed 

Bit 1 = 1 If math coprocessor installed 

Bit O = 1 If diskette available for boot 


Single Function CBIOS Services 


431 


INT 12h Memory Size Service 


Description 


The Memory Size Service returns the contents of system RAM location 
40:13h in the AX register. This location contains the amount of available 
base memory in kilobytes as it is determined by the CBIOS power-on self 
test and initialization routine (POST). 


POST determines the amount of available base memory according to the 
formula below: 


Available base memory Installed base memory 


Memory reserved for 
Extended Data Area 


Upper 1K reserved for BIOS 
Extended Data Area 


Note: The CBIOS Extended Data Area generally occupies 1K of upper mem- 
ory. In systems with 640K of installed base memory, the Memory Size 
Service will report 639K of available base memory. 


How the service is invoked 
INT 12h invokes the CBIOS Memory Size Service. 


The INT 12h vector resides at the Interrupt Vector Table address 0:48h. The 
CBIOS initializes the INT 12h memory size service vector to address 
FOOO:F841h, the IBM-compatible entry point. 


Input/Output 
Input: None 


Output: Available Base Memory 
AX = Contents of location 40:13h in binary form 
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INT 19h Bootstrap Loader Service 


Description 


The Bootstrap Loader Service attempts to load the 512-byte boot sector 
code from either floppy or fixed disk to address 0:7COOh, transferring control 
to that code segment. 


The boot code is located in the first sector of the floppy diskette (track OQ, 
head QO, sector 1) or in the first sector of the fixed disk (cylinder 0, head 0, 


sector 1). 
Input/Output 
Input: = None 
= None (registers are preserved) 


Output: 


How the service is invoked 
INT 19h invokes the CBIOS Bootstrap Loader Service. 


The INT 19h vector resides at the Interrupt Vector Table address 0:64h. The 
CBIOS initializes the INT 19h Bootstrap Loader Service vector to address 
FOOO:E6F2h, the IBM—compatible entry point. 


Note: INT 19h is usually invoked by the power-on self test and initialization 
(POST) routine at the end of all POST processing. CBIOS users are 
free to invoke INT 19h independently of POST. Users should be 
aware, however, that invoking INT 19h does not reset or reinitialize 
the system but simply causes the system to reboot. For more infor- 
mation on POST and INT 19h, refer to Chapter 6 of this volume. 


continued 
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INT 19h Bootstrap Loader Service, Continued 


Bootstrap processing 


Once INT 19h has been invoked, the Bootstrap Loader Service executes as 
described below: 


1. Locate and load The boot code, located in the first sector of the floppy, under- 
boot code takes the following processing: diskette (track 0, head 0, sec- 
tor 1) or in the first sector of the hard disk (cylinder 0, head 
0, sector 1). The Bootstrap Loader attempts to locate the 
boot sector and load it into memory at address 0:7COOh. 


2. Check for The Bootstrap Loader Service tests for the presence of a sys- 
power-on tem power-on password before it attempts to transfer control 
password to the boot code. End users enable or disable the power-on 

ay password via the Reference Diskette. 


3. If power-on If the Bootstrap Loader finds the power-on password is 
password enabled enabled, it provides the user with three opportunities to enter 
the password correctly. After three attempts the system halts 
and must be turned off, then turned on again before INT 19h 
may be invoked again. The Bootstrap Loader recalculates the 
CRC if the power-on password has been changed. 


4. Process boot Once power-on password issues have been resolved, the 
code, if found | Bootstrap Loader Service transfers control to the boot code if 
it has been located. 


5. If no boot code If the Bootstrap Loader Service does not find the boot sector 
found, invoke INT code, it invokes INT 18h. By default, INT 18h displays the 
18h. message “No boot device available, press F1 to continue.” 

(See INT 18h DSR handler below.) 


INT 18h DSR handler 


lf no boot sector is found either on the diskette in drive A: or on the fixed 
disk, Bootstrap Loader Service invokes software interrupt INT 18h. INT 18h 
can be vectored to a “no boot device” routine which takes over the boot 
process. For example, INT 18h can be vectored to a routine that would allow 
the system to be booted over a network. 


By default, the CBIOS initializes INT 18h to point to a routine that displays the 
message: “NO BOOT DEVICE AVAILABLE, PRESS F1 TO CONTINUE.” 


continued 
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INT 19h Bootstrap Loader Service, Continued 


INT 19h and the power-on password 


The Bootstrap Loader Service maintains a flag which is set when the power- 
on password has been input correctly. Once the power-on password is input 
correctly, INT 19h may be invoked again (either directly or through <Ctrl> 
<Alt> <Del> warm boot) without requiring user re-entry of the password. 


Password Messages 
In PS/2 MCA-compatible systems, security is implemented primarily by 
password control. There are two types of password control: 
=» sign-on, which controls access to the system, and 
» keyboard security, which controls access to the keyboard. 


Several messages relate to password control. They are described in the 
following table. 


Enter password A password has been Enter the correct 1-7 
installed and now controls | character password. 
access to the system. 


Password Ok A correct password has No action. 
been entered. 


Password has been The old password has No action. 
removed been deleted. Now there 
is no password protection 


until a new password is 
entered. 


New password has been A new password is now Use the new password to 
installed entered. access the system. 


System halted! Must An incorrect password Enter the correct password. 
power down was entered. The system 

stops and must be 

rebooted. 


Password is incorrect Incorrect password Enter the correct password. 
entered. 


Models 25 and 30: Password control is not available in PS/2 compatible 
systems (such as Models 25 and 30) which are not 
MCA-based. 


continued 
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INT 19h Bootstrap Loader Service, Continued 


1/O Ports Used 
INT 19h, Bootstrap Loader Service, references the following !/O ports: 


Read/Write 
1/O Address Status Description 


0060h | RIW. | Keyboard/auxiliary data port 
oo64h =| = ws s(8042 Commands 


8042 Status, where: 


Bit 7 = 1 Parity error 
Bit 6 = 1 General time out 
Bit 5 = 1 Auxiliary output buffer full 
Bit 4 = 1 Inhibit switch 
Bit 3 = 1 Command 

0 Data 
Bit 2 = System flag 
Bit 1 = 1 Input buffer full 
Bit 0 = 1 Output buffer full 


CMOS RAM address register port, where: 


Bit 7 = 1 NMI disable 
= 0 NMI enabled 
Bits 6- 0 = 0 CMOS address 


0071h_ [nw CMOS RAM data register port 


Arbitration register, where: 


Bit 7 = 1 Enable system microprocessor cycle 
Bit 6 = 1 Arbitration mask 
= 1 Enable extended arbitration 


Arbitration register, where: 


Bit 7 = 1 System microprocessor cycles enabled 
Bit 6 = 1 Arbitration mask by NMI 

Bit 5 = 1 Bus timeout 

Bit 4 = 0 Reserved 


Bits 3-0 = Arbitration level 


System control port A, where: 


Bit 7 = 1 Fixed disk activity light bit A on 
Bit 6 = 1 Fixed disk activity light bit B on 
Bit 5 = Reserved 

Bit 4 = 1 Watchdog time-out occurred 
Bit 3 = 1 Security lock latch Is locked 

Bit 2 = Reserved 

Bit 1 = 1 Alternate gate A20 active 

Bit O = 1 Alternate hot reset 


System board setup enable register, where: 


Bit 7 = 0 Enable system board setup 
= 1 Disable system board setup 

Bit 6 = 1 Reserved 

Bit 5 = 0 Enable VGA setup 


1 Disable VGA setup 
Bits 4-0 = 1 Reserved 
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INT 19h Bootstrap Loader Service, Continued 


System RAM data 


The Bootstrap Loader Service uses three system RAM data definitions. The 
definitions are located in the BIOS Data Area (absolute hex address 400h to 
500h) and are defined in the table below. 


eye 
40:72h 1 Word 

1234h = Bypass memory text 

4321h = Reserved for ABIOS 


40:75h Number of fixed disk drives 


CMOS RAM data . 


The Bootstrap Loader Service uses four CMOS RAM data areas. The defini- 
tions are located in the standard CMOS RAM Data Area and are defined in 
the table below. 


Diagnostic status, where: 


Bit 7 =1 Real time clock has lost power 

Bit 6 = 1 CMOS checksum is bad 

Bit5 =1 Invalid configuration 
information found at POST 


Reserved for manufacturer’s test, where: 


Bits 7-1= Reserved 
BitO =1 Manufacturing test mode 
= 0 Nonmanufacturing test mode 


System Reset Flag Where: 


Bit 4 = 1 Sooo size compare error found at 
Bit 3 Fixed disk or adapter fails initialization 


= 1 
Bit 2 = 1 CMOS time found invalid 
Bit 1 = 1 Adapters do not match configuration 
BitO =1 Time-out in reading an adapter ID 


Password Configuration 
Bits 7-2= 0 Reserved 


Bit 1 = 1 Network password installed 

= 0 Network password not installed 
Bit 0 = 1 Power-on password installed 

= 0 Power-on password not installed 
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Appendix A 
CBIOS Error Messages 


Overview 


Introduction 


The CBIOS can generate a variety of messages. Messages can be merely 
informational, or can alert the user to a hardware or software failure. 


A Phoenix CBIOS generates both beep codes (useful for error conditions 
when POST is not completed and the monitor is not yet initialized by the 
system) and screen error messages. 


In this appendix 
This appendix lists all CBIOS error messages and beep codes. The following 
information is presented: 
» POST: Error Handling 
» POST: Beep Codes 
» POST: System Failure Messages 
=» POST: Boot Failure Messages 
» POST: Informational Messages 
» NMI: Run Time Messages 
» INT 19h: Password Messages 
= Model 25 and 30 Beep Codes 
= Model 25 and 30 Error Messages 
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POST: Error Handling 


Introduction | 
The Phoenix POST reports test or initialization failures in one of the follow- 
ing ways: 
= Beep codes 
=» System failure messages 
= Boot failure messages 
= Informational messages 


Beep codes 


When a POST test fails before the video screen is available for display, POST 
halts the processor and notifies the user by sounding a series of beeps. 
Beep codes are written to a hardware test I/O port. The default value for the 
hardware test I/O port is O680h, but it may be different in some systems. 


Hardware test equipment external to the system can be used to read this 
information. 


Beep codes are generated by the Phoenix CBIOS only. 


System failure messages 


POST notifies the user of a test or initialization failure by displaying a mes- 


sage on the screen. Each message is preceded by an error code. The error 
code is also stored in the POST error log. 


End users use the reference diskettes supplied with their systems to run a 


utility program that provides a detailed explanation of each error stored in 
the POST error log. 


The IBM CBIOS displays only the numeric error code for a given system 
failure. 


continued 
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POST Error Handling, Continued 


Boot failure messages 


Once the POST test and initialization procedures are completed, POST boots 
the system by issuing software interrupt, INT 19h System Boot load. If this 
process fails, POST displays a screen message or graphic. System boot 


messages are not preceded by a numeric error code and are not logged 
into the POST error log. 


Informational messages 


In addition to error messages, the CBIOS POST also generates a set of 
messages that inform the user of the progress of POST memory testing. 
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POST: Beep Codes (Phoenix CBIOS Only) 


When a POST test fails before the video screen is available for display, the 
Phoenix CBIOS POST notifies the user by sounding a series of beeps, and 
halts the processor. Beep codes are also written to a hardware test |/O port. 
The default value for this port is in I/O port 680h, but it may vary. Hardware 
test equipment external to the system can be used to read this information. 


Be | FERRE | teton 
Code Port 680h_ Description | | 

| mone | th | CPU register test In progress 
pts | tah | CMOS write/read faire 
ptt4 | 03h | ROM BIOS checksum failure 
pet | 04h Programmable interval timer failure 
p22 | 08h | DMA nitiaization faiture 
| 23 | 0ch___—|_-DMApage register write/read falure 
| st | eh | RAM refresh verification failure 
| none | Osh | First 64K RAM test in progress 
p83 | oAn | First 64K RAM chip or data tine failure multibit 
p34 | Bh | First 64K RAM odd/even logic failure 
pat | och | Address tine failure first 64K RAM 
p42 | 0bh | Parity falure first 64K RAM 
=e ae ee 
pee | th 
ee ee 
Se ee 
ee ee 
pee | sh 
ee ee 
a eee 
Se ee 
| eae | sh 
a ee 


Bit 6 first 64K RAM chip or data line failure 
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POST: Beep Codes (Phoenix CBIOS Only), Continued 


Contents 
Port 680h 


Beep 
Code 


2-3-4 
2-4-1 
2-4-2 
2-4-3 


Description 


Bit B first 64K RAM chip or data line failure 
Bit C first 64K RAM chip or data line failure 
Bit D first 64K RAM chip or data line failure 
Bit E first 64K RAM chip or data line failure 
Bit F first 64K RAM chip or data line failure 


1Ch 
1Dh 


h 
Slave DMA register failure 

Master DMA register failure 
2 


nN 


h Master interrupt mask register failure 
Slave interrupt mask register fallure 
2 


2 


oO 


h 
h 


Interrupt vector loading in progress 


“J 


—_ 
Tl 


Keyboard controller test failure 


28h CMOS power failure and checksum calculation in 
progress 


none 29h CMOS configuration validation in progress 
2B 
Cc 


> 


Screen memory test failure 


Screen initialization failure 


NO 


=> 


Screen retrace test failure 
Search for video ROM in progress 
Screen operable 

Screen running with video ROM 


Monochrome monitor operable 


32h Color monitor (40 column) operable 


Color monitor (80 column) operable 
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POST: System Failure Messages 


444 


errer: 
Possible Cause hes aaeeead Solution 
System Board Failure Timer 0 or 2 failed | Replace the system 
during POST. board. 


| System Board Failure | The timer interrupt failed ecard the system 
while testing timer O dur- 
ing POST. 


| System Board Failure An unexpected interrupt 
| has occurred while the 
processor was in pro- 


tected mode. 


| System Board Failure Timer 2 failed during | Replace the system 
POST. board. 


| Option ROM Check- The checksum | Replace the failing 

| sum Failure — xxxx:0 | calculated for an option | option ROM or adapter 
ROM does not match | card containing the 
the checksum stored in option ROM. 

the option ROM. XxXXX 
indicates the segment 
address of the failing 


| Replace the system 
board. 


| option ROM. 
System Board Fallure A shutdown failure has Ricerca the system 
occurred during POST. board. 
| System Board Fallure | r Gatine of the A20 | Replace the system 


address line failed when | board. 
entering/exiting pro- 


tected mode. 


Real Time Clock Fail- 
ure (battery) Please 
Reconfigure and Retry 


Replace the battery. 
If the problem persists, 
replace the system 

| board. 


The real time clock’s 
bad battery flag bit is 
set. 


Run the Reference 
Diskette to update 
CMOS. If the problem 
persists, replace the 

| battery. if the problem 
still occurs, replace the 
system board. 


The checksum for the 
CMOS in the real time 
clock is incorrect. 


Real Time Clock Fail- 
ure (CRC) Please 
ppeeonnes and Retry 


continued 
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POST: System Failure Messages, Continued 


Error 
Possible Cause Suggested Solution 


Time and Date Not 
Set 


164 Invalid Configuration 
Information (Memory) 
Piease Reconfigure 
and Retry 

165 Invalid Configuration 


| Information (Adapter) 
Please Reconfigure 
and Retry 


Invalid Configuration 
information (Adapter) 
Please Reconfigure 
and Retry 


Invalid Configuration 


167 
Information (diskette) 
Invalid configuration in- 
formation (System 
board) 

201 Memory Failure at 


Xxxx:yyyy, Read aa, 
Expecting bb 


CBIOS Error Messages 


The date and time in the 
real time clock has not 
been set or has been 
corrupted. 


The amount of memory 


found in the system does 
not match the amount of 


memory specified in 
CMOS. 


An adapter configured 

by the Reference Disk- 
ette program does not 

exist in the correct slot 
in the system. 


An adapter configured 
by the Reference Disk- 
ette either 


» does not exist in the 
slot specified by the 
system, or 


=» is not responding. 
Diskette adapter does 


not exist or is not 
responding. 


Math coprocessor either 


| not operating or missing. 


A read/write error has 
occurred in memory at 
the address specified by 
‘xxxx:yyyy.’ The test 
value written to the 
memory location is indi- 
cated by ‘bb’ and the 
value read from the 
memory location is indi- 
cated by ‘aa.’ 


Run the Reference 
Diskette to update time 
and date. If the prob- 
lem persists, replace 
the battery. If the 
problem still occurs, 
replace the system 
board. 


Run the Reference 
Diskette to correctly 
configure the system. 
If the problem persists, 


| replace the system 


board. 


| Run the Reference 


Diskette to correctly 
configure the system. 


Run the Reference 
Diskette to correctly 
configure the system. 
If the problem persists, 


| replace the adapter. 


Run the Reference 


| Diskette to configure 


the system. Replace 
the adapter if problem 
persists. 


Either replace copro- 
cessor or reconfigure. 


Replace the memory in 
the system. If the 
problem persists, re- 
place the system 
board. 
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POST: System Failure Messages, Continued 


Error 
Possible Cause Suggested Solution 


446 


Memory Failure at 
Xxxx:yyyy, Read aa, 
Expecting bb 


Memory Failure at 
Xxxx:yyyy, Read aa, 
Expecting bb 


Keyboard Failure 


Keyboard Failure 


Keyboard Failure 


A memory parity error 
has occurred in memory 
at the address specified 
by ‘xxxx:yyyy.’ The test 
value written to the 
memory location is indi- 
cated by ‘bb’ and the 
value read from the 
memory location is indi- 
cated by ‘aa.’ 


An address line failure 
has occurred in memory 
at the address specified 
by ‘xxxx:yyyy.’ The test 
value written to the 
memory location is indi- 
cated by ‘bb’ and the 
value read from the 
memory location is indi- 
cated by ‘aa.’ 


The keyboard controller 
has failed during POST. 


The clock line on the 
keyboard controller has 
failed during POST. 


The data line on the key- 
board controller has 
failed during POST. 


Replace the memory 
in the system. If the 
problem persists, re- 
place the system 
board. 


Replace the memory 
in the system. If the 
problem persists, re- 
place the system 
board. 


Check the keyboard to 
make sure it is func- 
tioning correctly and is 
installed correctly. If 
the problem persists, 
replace the system 
board. 


Check the keyboard to 
make sure it is func- 
tioning correctly and is 
installed correctly. If 
the problem persists, 
replace the system 
board. 


Check the keyboard to > 
make sure it is working 
correctly and is in- 
stalled correctly. If the 
problem persists, re- 
place the system 
board. 
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POST: System Failure Messages, Continued 


Error 
Code Possible Cause Suggested Solution 


307 Keyboard Failure A stuck key has been Check the keyboard to 
detected on the make sure it is working 
keyboard. correctly and is in- 
stalled correctly. If the 
problem persists, 
replace the system 
board. 


The diskette controller 
has failed and should be 
replaced. 


The reset function has 
failed on the diskette 
subsystem. 


Diskette Drive Failure 


The drive is malfunc- 
tioning and should be 
replaced. 


The seek function 
has failed on diskette 
drive x. 


Diskette Drive x 
Failure 


Parallel Port Failure Parallel printer data port 


failed. 


Use an alternate printer 
port or replace the sys- 
tem board. 


Use an alternate serial 
port or replace the sys- 
tem board. 


Check the fixed disk 
controller. Check all 
connections. If the 
problem persists, test 
the drive using the Ref- 
erence Diskette. 


Check the fixed disk 
controller. Check all 
connections. If the 
problem persists, test 
the drive using the Ref- 
erence Diskette. 


Serial Port Failure The serial port on the 


system board has failed. 


1780 Fixed Disk Drive 0 


Fallure 


Fixed disk drive 0 is not 
ready, or the recalibra- 

tlon function failed during 
initialization. 


1781 Fixed Disk Drive 1 


Failure 


Fixed disk drive 1 Is not 
ready, or the recalibra- 
tion function failed during 
initialization. 


1782 Fixed Disk Reset 


Failure 


Check the fixed disk 
controller. Check all 
connections. If the 
problem persists, test 
the drive using the Ref- 
erence Diskette. 


Fixed disk failed reset. 


| Run Reference Diskette 
to determine if the disk 
is usable. 


1790 Fixed Disk Drive 0 


Failure 


The verify function has 
failed on fixed disk 
drive 0. 


continued 
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POST: System Failure Messages, Continued 


Error | | 
Possible Cause | Suggested Solution | 


1791 Fixed Disk Drive 1 The verify function | Run the Reference 
| Failure has failed on fixed disk Diskette to determine if 
controller has failed dur- 


| ! drive 1. the disk is usable. 

2401 | Video Failure 

ing POST. 
Video Failure The system board video | Replace the system 

controller has failed dur- | board. 
ing POST. 

7000* Chip Set CMOS Failure} Bad chip set battery, or | Replace the chip set 
bad CMOS RAM. battery. 


| 7001* | Chip Set Shadow RAM | ROM not shadowed to | Enable RAM shadowing 
| Failure RAM. | again. If still generated, 
| | bad or nonexistent | 


The system board video | Replace the system 


board. 


RAM. 


Chip set CMOS has in- 
correct information. 


Bad Configuration In- 
formation in CMOS 


7002* Reconfigure with the 
| Reference Diskette. If 
error persists, replace 
| CMOS battery or 


CMOS RAM. 


Check the pointing de- 
| vice for proper opera- 
| tion. If the problem 
persists, replace the 
device. If the problem 
still occurs, replace the 
system board. 


The pointing device 
(mouse) was detected 
but did not accept a 

| command. 


Pointing Device 
Interface Failure 


8601 


| 8602 
8603 


* Indicates an error code that occurs only in the Phoenix BIOS. 


| Check the pointing de- 
| vice for proper opera- 
tion. If the problem 

| persists, replace the 
device. If the problem 
still occurs, replace the | 
system board. 


The pointing device 
(mouse) was detected 
but an interface error 
occurred while testing. 


Pointing Device 
Interface Failure 


The pointing device 
(mouse) was detected 
but a time-out occurred 
while attempting to 
access it. 


Pointing Device Failure | Check the pointing de- 
vice for proper opera- 
tion. If the problem 

| persists, replace the 

| device. If the problem 
still occurs, replace the 
| system board. 
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POST: Boot Failure Messages 


Description 


Once the POST test and initialization procedures are completed, POST boots 
the system by issuing a software interrupt, INT 19h System Bootload. If 
there is a failure in this process, POST displays a message or graphic on 
the screen. 


Unlike those associated with failures in POST test or initialization procedures, 
system boot messages are not preceded by a numeric error code and are 
not logged into the POST error log. 


The table below lists the POST system boot error messages, their possible 
cause, and suggested solution. 


Possible Cause Suggested Solution 


Not a Boot Diskette The diskette in the disk- Remove diskette and retry 
ette drive does not con- boot. If no fixed disk is avail- 
tain a valid bootstrap sec- | able, insert a diskette known 
tor. Either the diskette is to be bootable, then retry 
defective or has not been | boot. 
formatted. 


A read of diskette drive 0 
timed out, and no fixed 
disk is available from 
which to boot. 


No Boot Device Available 


Retry boot. If the problem 
persists, replace the diskette 
or fixed disk. 


| A read of diskette drive 0 
timed out, and a read of 
the fixed disk failed. The 
fixed disk is probably 

| defective. 


Fixed Disk Read Failure Retry boot. If the problem 
persists, replace the fixed 


| disk. 


Retry boot with a diskette 
known to be bootable. Try for- 
matting the fixed disk and/or 
running FDISK, then retry 
boot. If the problem persists, 
replace the fixed disk. 


| A read of diskette drive 0 
timed out, and the boot- 
strap sector on the fixed 
disk is invalid. The fixed 
disk is either defective, 
has not been formatted, 
and/or has never had 
FDISK (or a comparable 
utility) run on it. 


No Boot Sector on 
Fixed Disk 
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POST: Informational Messages 


Description 


The following messages are for informational purposes only and do not 
report error conditions. 


— xxXxK Base Memory | The amount of base memory in kilobytes 
that tested successfully. 


XXxK Expanded Memory The amount of expanded memory in kilo- 
bytes that tested successfully. 

xxxK Extended Memory The amount of extended memory in kilobytes 

that tested successfully. | 
XxxK Extra Memory The amount of extra memory in kilobytes 
| that tested successfully. 

XxxK Standard Memory The amount of standard memory in kilobytes 
that tested successfully. 

Decreasing available memory This message immediately follows any mem- 
ory error messages and indicates that the 
memory chips are failing. 


Memory tests terminated by keystroke This message indicates that the spacebar 
was pressed while the memory tests were 
running, which stops the memory tests. 


This message indicates that an error was 
found during POST. Pressing the F1 key al- 
lows the system to reboot. 


Strike the F1 key to continue 
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NMI: Run Time Messages 


Phoenix CBIOS NMI error messages 


The Phoenix CBIOS NMI service generates the following run time error 


messages: 


Error 
Possible Cause Suggested Solution 


Memory Parity Error 


at Xxxxx 


at XXxxx 


1/O Card Parity Error 


Watchdog Time-out 


DMA Bus Time-out 


Memory is failing. If the 
NMI handler can deter- 
mine the address of the 
failing memory, it will be 
displayed in place of 
XXXXxX. If the failing mem- 
ory is not found, then 
the message will read 
“Memory Parity Error 
vet ae oe dda 


The peripheral card has 
failed. If the NMI handler 
can determine the ad- 
dress of the failing mem- 
ory, it will be displayed in 
place of xxxxx. If the 
failing memory is not 
found. then the message 
will read “I/O Card Par- 
ity Error ??7?”. 


The watchdog timer has 
detected that the timer 
0 interrupt has not been 
serviced. A program or 
device has probably 
failed while interrupts 
were off. 


A device has driven the 
-BURST signal line for 
more than 7.8 micro- 
seconds, causing the 
central arbiter device 
(on the motherboard) 
to generate a bus 
time-out. 


Check the system 
board and all installed 
devices for proper op- 
eration. Replace if 
necessary. 


Check the system 
board and all installed 
devices for proper op- 
eration. Replace if 
necessary. 


Reboot the system. If 
the problem persists, 
check ali installed de- 
vices for proper opera- 
tion. Replace if neces- 
sary. If the problem still 
occurs, examine all 
programs for errors 
which cause the inter- 
rupts to remain off. 


Check system board 
and all installed devices 
for proper operation. 
Replace if necessary. 
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NMI: Run Time Messages, Continued 


IBM CBIOS NMI error messages 


IBM PS/2 systems have a different set of error messages. The messages 
are followed by the segment address of the bad memory location or ???°? if 
it cannot be found. These error codes and messages are listed in the follow- 
ing table: 7 


| to System Board Memory Failure 
1/O Channel Check Activated 
113 | Direct Memory Access (DMA) Bus Time-out 


Models 25 and 30: IBM PS/2 Models 25 and 30 support memory parity error 
in the same way as other PS/2 systems but substitute 
the message PARITY CHECK1 for message 110 and 
PARITY CHECK2 for message 111. 


Time-out error handling is not Supported on IBM PS/2 
Model 25 and 30 systems. 
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INT 19h: Password Messages 


Description 


In MCA-based PS/2 and compatible systems, The CBIOS INT 19h Bootstrap 
Loader Service performs password checking after the boot sector is loaded. 


Several messages relate to password control. They are described in the 


following table. 
Message | cause | Solution 
| A password has been Enter the correct 1-7 


Enter password 
installed and now controls | character password. 
access to the system. 


Password Ok A correct password has No action. 
been entered. 


Password has been The old password has No action. 
removed been deleted. Now there 
| is no password protection 
until a new password is 

entered. 


Use the new password to 
access the system. 


New password has been 
installed 


A new password Is now 
entered. 


Re-enter the correct 
password. 


System halted! Must 
power down 
rebooted. 


Password is incorrect Incorrect password Re-enter the correct 
entered. password. 


Models 25 and 30: Password control is not available in PS/2-compatible 
systems (such as Models 25 and 30) which are not 
MCA-based. 


An incorrect password 
was entered. The system 
stops and must be 
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Model 25 and 30 Beep Codes 
Contents 


Port 90h Description 


Oth CPU register test in progress 
ROM BIOS checksum failure 


Beep 
Code 


_ 
| 

—_ 
{ 

BN 


DMA initialization failure 


DMA page register write/read failure 
RAM refresh verification failure 


_ 
{ 
° 
_ 


First 64K RAM test in progress 
First 64K RAM chip or data line failure multi-bit 


0 
0 
0 
0 
0A 
06 


| Parity failure first 64K RAM 
10h Bit 0 first 64K RAM chip or data line failure 


~~ 
—_ 
I 

=i, 


1th Bit 1 first 64K RAM chip or data line failure 
Bit 2 first 64K RAM chip or data line failure 
Bit 3 first 64K RAM chip or data line failure 


1 Bit 4 first 64K RAM chip or data line failure 


12h 


15h Bit 5 first 64K RAM chip or data line failure 


FB 9 st 64K RAM chip or data ne fare 
r 


Bit13 first 64K RAM chip or data line failure 


Sh 
6h 
8h 
9h 
h 
h 
4h 
h 


fel oa 
a Pale 
w a 


‘ 
ie 
awh 


2-4-3 
2-4-4 


° 
ae 
BS 


2 


1Fh 
22h 
25h 
27h 
Ch 
2Eh | 
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Model 25 and 30 Error Messages 


Model 25 and 30 POST error message table 


Message 


Diskette drive 1 seek 
failure 


Diskette drive reset 
failed 


Diskette read failure — 
strike F1 to retry boot 


Display adapter failed; 
using alternate 


Errors found disk X: 
Failed Initialization 


Errors found 


incorrect configuration in- 


formation memory size 
miscompare 


The diskette adapter has Check the diskette adapter. 
failed. 


The diskette is either not Replace the diskette with a 
formatted or defective. bootable diskette and retry 
boot. 


The color/monochrome Change the switch to the 
switch is incorrect. correct setting. 


The primary video , Check the primary video 
adapter failed. adapter. 


POST reports fixed disk Rerun SETUP and enter 
configuration information correct fixed disk 
is incorrect. information. 


POST reports the size of Rerun SETUP and enter 
base or expansion mem- correct memory size. 
ory does not agree with 

configuration information. 


Fixed disk configuration The specified configuration 
error is not supported. configuration. 
Fixed disk controller The controller card has 
failure failed. 
Fixed disk failure Bad disk. Retry boot. If that doesn’t 
work, replace the fixed disk. 
Fixed disk read failure — The fixed disk is defective. Retry boot. If that doesn’t 
| strike F1 to retry boot work, replace the fixed disk. 


Invalid configuration infor- | = Memory size is Run the SETUP utility. 
mation — please run incorrect. 
SETUP program = Display adapter Is 

| configured incorrectly. 


=» Wrong number of 
diskette drives. 


continued 
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Model 25 and 30 Error Messages, Continued 


Model 25 and 30 POST error message table, cont’d 


Keyboard clock line 
| failure 


Either the keyboard or 
the keyboard cable con- 
nection is defective. 


Make sure the keyboard 
cable and keyboard are 
|} connected properly. 


| Keyboard data line failure 


Keyboard controller | The keyboard controller Check the keyboard 
| failure firmware has failed. controller. 


Keyboard is locked — The keyboard lock lo- Unlock the keyboard. 
please unlock cated at the front of the 
computer is activated. 


Keyboard stuck key A key(s) is jammed. | Try pressing the key(s) | 
failure again. 


| Memory address line fail- Circuitry associated with | Check the circuitry. 
| ure at hex-value, read the memory chips has 
hex-value, expecting failed. 
hex-value 


Replace the memory 
chips. 


One of the memory chips 
or associated circuitry 
has failed. 


Memory data line failure 
at hex-value, read hex- 
value, hex-value 


Memory high address Check the circuitry. 
line failure at hex-value, 
| read hex-value, expect- 


ing hex—value 


Circuitry associated with 
the memory chips has 
failed. 


Memory chip circuitry Replace the memory chip. 


failed. 


| Memory double word 
logic failure at hex- 

| value, read hex-value, 
expecting hex-value 


Circuitry associated with Check the circuitry. 
the memory chips has 


failed. 


| Memory odd/even logic 

failure at hex-failure, 

|} read hex-value, expect- | 
ing hex-value : 


Memory parity failure at 
hex-value, read 
hex-value, expecting 
hex-value 


One of the parity memory 


Try replacing the memory 
chips has failed. 


| chips. 


One of the memory chips 
has failed. 


| Memory write/read fail- 
| ure at hex-value, read 
hex-value, expecting 

hex value 


| Try replacing the memory 
chips. 


continued 
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Model 25 and 30 Error Messages, Continued 


Model 25 and 30 POST error message table, cont’d 


No boot device Either diskette drive A:, Retry boot. If that doesn’t 
available — strike F1 to the fixed disk, or the disk- work, replace the floppy 
retry boot ette itself is defective. | diskette or the fixed disk. 


No boot sector on fixed The C: drive is not Format the C: drive, make 
disk — strike F1 to retry formatted or is not it bootable. 
boot bootable. 


Not a boot diskette — | The diskette in drive A: is Replace the diskette with a 
strike Fi to retry boot not formatted as a bootable diskette and retry 
bootable diskette. boot. 


No timer tick interrupt The timer haieiashesdamminarl has failed. Check the timer chip on the 
system board. 


| Hex-value optional ROM oceemarens peripheral card Replace the peripheral 
bad checksum = contains a defective ROM. card. 
hex-value = 


Shutdown failure | The keyboard controller or Check the keyboard 


its associated logic has | controller. 
failed. 


Time-of-—day clock The Time-of-day clock Run the SETUP utility. 
stopped chip has failed. 


| Time-of- bay not set — Clock not set. Run the SETUP utility. 
please run SETUP 
program 


Timer chip counter 2 Chip failed. Check the timer chip 
failed system board. 


Timer or Interrupt con- Either the timer chip or | Check the timer chip or the 
| troller bad the interrupt controller is interrupt controller on the 
defective. system board. 


| Unexpected interrupt in | The nonmaskable interrupt Check the system board, 
protected mode 1 (NMI) port can’t be dis- | particularly the logic associ- 
| abled. ated with the nonmaskable 
| interrupt. 
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Model 25 and 30 Error Messages, Continued 


Model 25 and 30 POST Informational Messages 


Informational messages require no action but provide valuable information. 


XxxK Base Memory The amount of base memory in kilobytes 
that tested successfully. 

xXxxK Expanded Memory The amount of expanded memory in kilo- 

bytes that tested successfully. 

xxxK Extended Memory The amount of extended memory in kilobytes 
that tested successfully. 

xxxK Extra Memory The amount of extra memory in kilobytes 
that tested successfully. 

XxxK Standard Memory The amount of standard memory in kilobytes 
that tested successfully. 

Decreasing available memory This message immediately follows any mem- 
ory error messages and indicates that the 
memory chips are failing. 


Memory tests terminated by keystroke This message indicates that the spacebar 
was pressed while the memory tests were 
running, which stops the memory tests. 


Strike the F1 key to continue This message indicates that an error was 
found during POST. Pressing the F1 key al- 
lows the system to reboot. 


continued 
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Model 25 and 30 Error Messages, Continued 


Model 25 and 30 Run Time Messages 


The Model 25/30 bus may generate error messages if I/O or RAM errors 
occur. The possible errors are: 


Error Message Suggested Solution 
Memory address line failure at hex-value ... expecting Failed memory chip 
hex-value 

Memory data line failure at hex-value ... expecting Failed memory chip 
hex-value 

Memory double word logic failure at hex-value ... Failed memory chip 
expecting hex-value 

Memory high address line failure at hex-value ... expecting Failed memory chip 
hex-value 


Memory odd/even logic failure at hex-value ... expecting Failed memory chip 
hex-value 


Memory parity failure at hex-value ... expecting hex-value Failed memory chip 
Memory parity error at xxxxx Failed memory chip 


Memory read/write failure at hex-vaiue ... expecting Failed memory chip 
hex-value 


hex-value Optional ROM bad checksum = hex-value |/O card failed 
1/O card parity error at xxxx I/O card failed 
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Appendix B 
Keyboard/Mouse Controller 


Overview 


Introduction 


The overall CBIOS hardware environment is described in Chapter 2. How- 
ever, because it is so integral to the proper functioning of MCA-based PS/2 
computers, the 8042 peripheral controller chip, as well as its accompanying 
keyboard/mouse control firmware, are discussed in greater detail here. 


In this appendix 
This appendix presents the following information: 
® 8042 Hardware 
=» 8042 Firmware 
=» 80x86/8042 Device Interface 
» System Commands to 8042 
» 8042-to-System Replies 
» System Commands to Keyboard 
» Keyboard Replies to System 
» System Commands to the Mouse 
=» Mouse-to-System Replies 
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8042 Hardware 


Introduction 


The Intel 8042 peripheral controller is a single chip microcomputer that can 
be programmed to allow bidirectional communication between the master 
microprocessor and up to two auxiliary serial input devices. The 8042 chip is 


generally mounted on the system motherboard. 8042 programs reside as 
firmware in the 8042 chip itself. 


Note: Here the master processor, i.e. the 80286 or 80386, is referred to as 
the “system.” 


Device support 


The kind of devices a given 8042 chip supports are dependent on how the 
8042 is programmed. 


On IBM MCA-compatible systems, the 8042 is programmed to allow bi- 
directional communication between the system and the keyboard, as well as 
between the system and one other auxiliary serial device, such as a mouse, 
joystick, or trackball. 


8042 Keyboard/Mouse Controller functions | 
The 8042-based Keyboard/Mouse Controller in PS/2 MCA-compatible sys- 
tems supports the following functions: 
= Bidirectional keyboard interface 
=» Key code to 8042 scan code translation 
=» Keyboard password support 
# 8042 keyboard inhibit switch 
=» Access to processor RESET signal 
= Controlling gate A20 signal 
= Bidirectional auxiliary device interface 
» INT 74h interface to BIOS and auxiliary device driver 
=» Keyboard and auxiliary device error checking 


continued 
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8042 Hardware, Continued 


8042 microprocessor features 


The 8042 peripheral controller chip contains the following features: 


Feature Description 

Data Bus Input Register 8-bit write-only register accessed by the system at |/O 
addresses 064h and O60h. 

Data Bus Output Register 8-bit read-only register accessed by the system at 1/O 
address O60h. 

Status Register 8-bit read-only register accessed by the system at I/O 
address 064h. 


2KB ROM Contains the 8042 firmware 


256 Bytes RAM Locations 20h to 3Fh contain 8042 firmware data defini- 


tions and can be read and written to by the system. 
The remaining RAM is reserved as 8042 firmware work 
area. 


8-Bit Timer Controls 8042 scan rate. (See “Timing Facts” below) 

8-Bit Input Port Data/Commands received from the keyboard or auxil- 
lary device are transmitted through the 8042 input port. 

8-Bit Output Port Data/Commands sent from the 8042 to the keyboard or 


auxiliary device are transmitted from the 8042 output 
port. 


Keyboard Clock Input Pin Clock Input for keyboard. 
Aux. Device Input Pin Clock Input for auxiliary device. 


8042 timing facts 


The 8042 operates at a crystal frequency of 10 MHz. This gives a minimum 
count for the timer of 50 microseconds. When the 8042's 8-bit timer is 
started, it will increment to its maximum count (FFh), overflow to zero and 
continue to count. Incrementing from maximum to zero (overflow) sets the 
8042 timer flag and generates an interrupt request to the 8042. 


Note: Operating 8042 chips at a crystal rate other than 10 MHz may cause 
incompatibility problems. 


continued 
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8042 Hardware, Continued 


8042 Status Register definition 


The 8042 Status register is an 8-bit read-only register that is accessed by 
the system at I/O address 064h. The values of the Input Buffer Flag, Output 
Buffer Flag, Auxiliary Output Buffer Flag, and Command/Data Flag help 
coordinate the bidirectional transfer of information between the 8042 and 
the system. 


Status Register bit definitions | 
The bit definitions of the status register are as follows: 


Definition 


Bit 7 PARITY ERROR. 
When this bit is a 1, it Indicates that the last byte received from the key- 
| board or auxillary device had the incorrect parity. 


GENERAL TIME-OUT. 
When this bit is a 1, it indicates that a time-out has occurred during the 
Pees of data between the 8042 and the keyboard or the auxiliary 

evice. 


AUXILIARY DEVICE OUTPUT BUFFER FULL. 
When this bit is a 1, data received from the auxiliary device is present in 
the output buffer. 


INHIBIT SWITCH. 
Since there is no inhibit switch in the PS/2, this bit must be a 1, to indicate 
that the keyboard is not inhibited. 


COMMAND/DATA (F1). 


When this bit is a 1, the byte in the input buffer is a command for the 
8042. When this bit is a 0, the byte in the input buffer is either a data byte 


all for the 8042 or a command or data byte for the keyboard. 


SYSTEM FLAG (FO). | 
The 8042 replicates this bit from the system bit in the command byte. | 
|} Bit 1 INPUT BUFFER FULL. 
| When this bit is a 1, a byte is present in the input buffer. 
OUTPUT BUFFER FULL. 
When this bit is a 1, a byte is present in the output buffer. 


continued 
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8042 Hardware, Continued 


1/0 Port definitions 


The table below lists the bit definitions of the 8042 Input Port, Output Port, 
and Test Inputs. 


Input Bit 0 = Keyboard data input 
Bit 1 = Auxiliary device data input 
Bit 2 = Undefined 
Bit 3 = Fuse status of +5V dc line 
0 = Fuse is open 
1 = Fuse is closed 
Bit 4 = Undefined 
Bit 5 = Undefined 
Bit 6 = Undefined 
Bit 7 = Undefined 


Output Bit 0 = System reset 
Bit 1 = Gate A20 

Bit 2 = Auxiliary device data output 
Bit 3 = Auxillary device clock output 
Bit 4 = Output buffer full 

Bit 5 = Auxiliary output buffer full 
Bit 6 = Keyboard clock output 

Bit 7 = Keyboard data output 


Test TO =Keyboard clock input 
T1 = Auxiliary device clock input 
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8042 Firmware 


Description 


On MCA-based, IBM PS/2 and compatible systems, the 8042 peripheral 
controller is programmed with firmware that supports the Keyboard and one 
auxiliary device, usually a mouse. 


The 8042 firmware: 


processes commands received by the 8042 from the system, 

passes through those commands intended for the keyboard or the auxil- 
iary device, 

coordinates input from both the keyboard and the auxiliary device, 
Outputs keyboard or auxiliary device data to the data bus, 

pulses IRQ 1 to initiate INT 09h, the CBIOS Keyboard Service ISR, and 
pulses IRQ 12 to initiate INT 74h, the Auxiliary Device ISR. 


Phoenix scan code support 


IBM—compatible keyboards that are attached to MCA-based PS/2 systems 
generate IBM keyboard scan code set 2, as defined in Chapter 8. Phoenix’s 
8042 firmware supports keyboard scan code set 2 only. 
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8042 Firmware, Continued 


8042 firmware data definitions 
The 8042 Peripheral Controller chip contains 256 bytes of internal RAM. 
Firmware for the 8042 has the ability to read/write to 8042 RAM locations 
O20h to O3Fh. The 8042 firmware data is defined in the table below. 


Location Initial Value Description 


20h 30h Command byte 


The command byte is a byte that is stored in the 
8042 at RAM location 20h. It contains 8 flag bits 
that are used by the program. The command byte 
can be written or read by the system. The bit defi- 
nition of the command byte is as follows: 


Bit 7 = Reserved, must be 0. 


Bit 6 = IBM PC Compatibility Mode. When this bit is 
a1, the 8042 translates the scan codes re- 
ceived from the keyboard to those used by 
the IBM PC. When this bit is a 0, the 8042 
passes the scan codes to the system with- 
out translation. 


Bit 5 = Disable Auxiliary Device. When this bit is a 
1, the 8042 disables the auxiliary device by 
setting the auxiliary device ciock jine iow. 


Bit 4 = Disable Keyboard. When this bit is a 1, the 
8042 disables the keyboard by setting the 
keyboard clock line low. 


Bit 3 = Reserved 


Bit 2 System Flag. The value of this bit is written 
to the system flag bit (FO) of the status 
register. 


Enable Auxiliary Output Buffer Full Interrupt. 

When this bit is a 1, the 8042 generates an 

interrupt to the system by setting the Auxil- 

lary OBF port bit (output port 2, bit 5) high, 

en it places a byte in the 8042 output 
uffer. 


Enable Output Buffer Full Interrupt. When 
this bit is a 1, the 8042 generates an inter- 
rupt to the system by setting the OBF port 
bit (output port 2, bit 4) high, when it 
places a byte in the 8042 output buffer. 


Bit 1 


Bit 0 


Number of times 8042 will send Resend command to 
device, if data received with error. 


22h OBh If not 0, device is read for a response to a trans- 
| mission. 
[on 


Running count of number of Resends sent to key- 
board since power-up. 


Initialized, but never used. 
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8042 Firmware, Continued 


8042 firmware data definitions, cont’d 


Initial Value Description 


eS 
P intiaized, but never used. 
 dlaied, but never wed. 


= 80h when break code (FOh) received from 


| keyboard 
= 00h after adding 80h to key scan code 


| 27h | 

| AH | th 

pach | th 
If not 0, device is read for a response to a trans- 
mission. 

WE Ea 

| th | Oh 

[sm [oh 


iary device since power-up. 


[code forrant ar en) 


Note: The initial values shown here are set by the 8042 firmware initialization at run 
hin They may be changed by the CBIOS POST or other routines at a later 
me. 


F8eh 

Eh 
00h ~ Running count of number of Resends sent to auxil- 
00h 


80x86/8042 Device Interface 


Introduction 


The figure below illustrates the relationship between the system, the 8042 
peripheral controller chip, the keyboard, and the auxiliary device. 


continued 
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80x86/8042 Device Interface, Continued | 


OPERATION 


60h, 64h | Write 


» Commands from the 
system to the 8042 are 
written to the 8042 Data 
Bus Input register via !/O 
address 064h. If an ac- 
companying data byte is 
expected the system 
must then write the data 
byte to I/O address 
060h. 


» Commands passed from 
the system directly to 

the keyboard are written 
to the 8042 input register 
via 1/O address O60h. 


OPERATION 


Read 


The values the 8042 firm- 
ware writes to the Status 
Register’s Output Buffer 
Full bit or Auxiliary Output 
Buffer Full bit determine 

| how the system will handle 
the data in the Output 
Buffer. 


» Data received from the 
keyboard or the auxiliary 
device is processed by 
the 8042 firmware and is 
placed into the 8042 out- 
put register. 


« The system processes 
keyboard data via INT 
09h. Data from the auxil- 
lary device is processed 
via INT 71h. 


Data Bus Output Registe 


soatedrerecmeeroamitatanstannestertnes 


PORT OPERATION 


Read 


The 8042 Status register is 
an 8-bit read-only register 
that is accessed by the 

| 80x86 at 1/O address 
0064h. 


The values of the status 
register’s Input Buffer Fiag, 
Output Buffer Flag, Auxil- 
lary Output Buffer Flag, 
and Command/Data Flag 
help coordinate the bidir- 
ectional transfer of infor- 
mation between the 8042 
and the system 


Status Register a Data Bus Input Register 


8042 Firmware 
The 8042 firmware functions as described below: 


» Processes commands received from the = Outputs data to the 8042 Data Bus 
system. Output Register 


« Updates the Status Register Output cS 
» Passes commands from the system Buffer Full bit and Auxiliary Output Buffer 
through to the keyboard/auxiliary device Full bit Bn 


= Coordinates input from both the keyboard " Pulses IRQ 1 to initiate INT 09h ISR 
and the auxiliary device » Pulses IRQ 12 to initiate INT 74h ISR 


pases sesonosscsonaten Output Port (Port 2) : Input Port (Port 1) 
: ) : , : 
IRQ 1 IRQ 12 ae 


| | 
INT 09h INT 71h 


Auxiliary Device 
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System Commands to 8042 | 


Introduction 


Commands from the system to the 8042 are written to the Data Bus Input 
Register, an 8—-bit write-only register that is accessed by the system at I/O 
addresses O064h. If an accompanying data byte is expected, the system must 
then write the data byte to I/O address O60h. 


8042 commands 


All 8042 commands are shown in the following table. 


READ THE 8042 COMMAND BYTE. 
Instructs the 8042 to send the contents of location 20h, the com- 
mand byte, to the system. 
21h - 3Fh READ THE 8042 RAM. 
Instructs the 8042 to send the contents of the RAM location, defined 
by bits 5-0 of the command, to the system. | 
uit WRITE THE 8042 COMMAND BYTE. 


Instructs the 8042 to write the data byte following the command to 
61h - 7Fh WRITE THE 8042 RAM. 

Instructs the 8042 to write the data byte following the command to 

the RAM location defined by bits 0-5 of the command. 


the location of the command byte (20h). 
TEST PASSWORD INSTALLED. 


Instructs the 8042 to check whether there is a password currently 
installed. If there is no password, the contents of the first location 
where the password would be stored will be zero. If there is a pass- 
word installed, FAh is placed in the 8042 output buffer, if not, Fih is 
placed in the buffer. 


LOAD SECURITY. 
Instructs the 8042 to read password data from the 8042 input buffer 
and store it until a null (0) is detected. The null is stored as the last 
byte of the password. 


ENABLE SECURITY. 
Instructs the 8042 to check the installed password against the in- 
coming keystrokes for a match. 


DISABLE AUXILIARY DEVICE INTERFACE. | 
Instructs the 8042 to set bit 5 of the command byte. This disables 
the auxiliary device by driving the auxiliary clock low. 


Note: The 8042 firmware will ignore any commands written to port 064h other than. 
those listed. 


continued 
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System Commands to 8042, Continued 


8042 commands, cont’d 


Command Description 


A8&h ENABLE AUXILIARY DEVICE INTERFACE. 
Instructs the 8042 to clear bit 5 of the command byte. This enables 
the auxiliary device by driving the auxiliary clock high. 


AUXILIARY INTERFACE TEST. 
Instructs the 8042 to test the auxiliary device clock and data lines. 
The result of the test is placed in the output buffer as follows: 


00 — No error detected. 

01 — Auxiliary device clock line is stuck low. 
02 — Auxiliary device clock line is stuck high. 
03 — Auxiliary device data line is stuck low. 
04 — Auxiliary device data line is stuck high. 


AAh SELF TEST. 
Instructs the keyboard 8042 to perform internal diagnostics tests. A 
55h is placed in the output buffer if no errors are detected. 


KEYBOARD INTERFACE TEST. 
Instructs the 8042 to test the keyboard clock and data lines. The 
result of the test is placed in the output buffer as follows: 


00 — No error detected. 

01 — Keyboard device clock line is stuck low. 
02 — Keyboard device clock line is stuck high. 
03 — Keyboard device data line is stuck low. 
04 — Keyboard device data line is stuck high. 


Reserved 


DISABLE KEYBOARD INTERFACE. 
Instructs the 8042 to set bit 4 of the command byte. This disables 
the keyboard by driving the keyboard clock low. 


ENABLE KEYBOARD INTERFACE. 
Instructs the 8042 to clear bit 4 of the command byte. This enables 
the keyboard by driving the keyboard clock line high. 


READ INPUT PORT. 
Instructs the 8042 to read the 8042 input port (port 1) and place the 
data in the 8042 output buffer. 


POLL INPUT PORT LOW. 

Instructs the 8042 to continuously read input port 1 bits 0-3 Into the 
status register, bits 4-7, until IBF goes high, when the next com- 
mand is executed. 


Note: The 8042 firmware will ignore any commands written to port 064h other than 
those listed. 


continued 
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System Commands to 8042, Continued 


8042 oan: cont’d 


472 


POLL INPUT PORT HIGH. 
Instructs the 8042 to continuously read input port 1 bits 4-7 into the 


| status register, bits 4-7, until IBF goes high, when the next com- 


mand is executed. 


READ OUTPUT PORT. 


Instructs the 8042 to read the 8042 output port (port 2) and place 


| the data in the 8042 output buffer. 


WRITE OUTPUT PORT. 
Instructs the 8042 that the next byte of data received should be sent 


| to the 8042 output port. 


WRITE KEYBOARD OUTPUT BUFFER. 

Instructs the 8042 that the next byte of data received should be sent 
to the output buffer. The controller will generate an interrupt to the | 
system if the interrupt bit is enabled in the command byte. 


WRITE AUXILIARY DEVICE OUTPUT BUFFER. 

Instructs the 8042 that the next byte of data received should be sent | 
to the output buffer. The 8042 generates an interrupt to the system 

if the interrupt bit is enabled in the command byte. 


WRITE TO AUXILIARY DEVICE. 
Instructs the 8042 that the next byte of data received should be © 


| transmitted to the auxiliary device. 


READ TEST INPUTS. 
Instructs the 8042 to read the 8042 TO and T1 inputs and place them | 


| in the output buffer. Bit 0 represents TO and bit 1 represents T1. 
|; PULSE OUTPUT PORT. 


Instructs the 8042 to pulse bits 0-3 of the output port (port 2) low 


| for 6 microseconds. Bits 0 through 3 of the command indicate the 
| bits to be pulsed. 


If the bit is a 0 then the corresponding bit on port 2 should be 
aera If the bit is a 1 then the corresponding bit should not be 
pulsed. 


Note: The 8042 firmware will ignore any commands written to port 064h other than 
those listed. 
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8042-to-System Replies 


Command list 
There are four 8042-to-system replies. 


[55 | NO ERROR DETECTED ON G04? FIRMWARE SELF-TEST. 
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System Commands to Keyboard 


Introduction 


Commands passed from the system directly to the keyboard are written to 
I/O address O060h. The value of the Status Register’s Command/Data Flag 
must be 0. 


Command list 


SET/RESET LED TOGGLE STATUS INDICATORS. 

The Num Lock, Caps Lock, and Scroll Lock LED indicators can be 
turned on or off by a command from the system. The EDh com- 
mand byte is written to port 060h and the keyboard responds with 
FAh (ACK). The system then writes the option byte to port 60h. 

A value of 1 means turn the LED on. The option byte takes the for- 
mat below: 


Bit Description 

7-3 Reserved (must be 00000b) 
Caps Lock LED 
Num Lock LED 
Scroll Lock LED 


ECHO. 
The system uses this command to test the keyboard. The keyboard 
issues an EEh (Echo) in reply to this command. 


INVALID COMMAND. 
The keyboard does not acknowledge this command. 


INVALID COMMAND. 
The keyboard does not acknowledge this command 


READ KEYBOARD ID BYTES. 
The keyboard acknowledges the command and sends the two key- 
board ID bytes. 


SET TYPEMATIC REPEAT RATE AND DELAY PERIOD. 
The system may set typematic rate and delay. 


ENABLE. 
Commands the keyboard to clear its output buffer and begin 
scanning. 


DEFAULT DISABLE. 

Resets all conditions within the keyboard to their power-on default 
state and disabies scanning. The keyboard responds with ACK, 
clears Its output buffers, and waits for the next instruction from the 
system. 


CHOOSE ALTERNATE SCAN CODE SET. 
The 8042 APCF supports scan code set 2 only. 


Ld 


continued 
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System Commands to Keyboard, Continued 


Command list, cont’d 


F6h SET DEFAULT 
Resets all conditions within the keyboard to their power-on default 
state and enables scanning. The keyboard responds with ACK and 
clears all output buffers. 


F7h - FDh RESERVED 


FEh RESEND. 
If the system detects an error in transmission, it Issues the resend 
command. The keyboard responds by sending the previous output. 
FFh RESET. 
System issues this command to invoke the keyboard’s internal self 
test. 
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Keyboard Replies to System 


Introduction 


Replies from the keyboard to the system are read by the system at port 
O60h. The keyboard to system replies are listed in the table below. 


Reply list 


476 


OOh OVERRUN CHARACTER 

(Code Sets 2 and 3) When the keyboard exceeds its buffer capacity, it places 00h 
(the overrun character) into the bottom of the keyboard 
buffer. When the overrun character reaches the top of the 
buffer, the keyboard sends it to the system. 


| 83ABh KEYBOARD ID 
The two-byte keyboard ID is defined as 83ABh. The keyboard 
replies to the keyboard ID command with ACK, then sends the 
low ID byte followed by the high ID byte. 


BAT COMPLETION CODE 

At power-on-reset the keyboard logic initiates a keyboard Ba- 
sic Assurance Test (BAT). If the BAT was successful, then 
the keyboard replies with AAh, the BAT Completion Code. 


BAT FAILURE CODE 

When the BAT is not completed successfully, the keyboard 
responds with FCh, the BAT Failure Code. The keyboard will 
then discontinue scanning, and it will wait for a Reset com- 
mand or some other response from the system. 


ECHO 
This is the keyboard’s reply to EEh, the system-to-—keyboard 
echo command. 
ACKNOWLEDGE (ACK) 
Keyboard reply to any valid system command other than Echo 
| or Resend. The keyboard will discard ACK if it receives an- 
va system command while it is attempting to reply with 


RESEND 
Keyboard receipt of invalid input or input with incorrect parity 
causes the keyboard to issue FEh, the Resend command. 


AAh 

FCh 

EEh | 

FAh | 

FEh 

FE OVERRUN CHARACTER 

(Code Set 1) When the keyboard exceeds its buffer capacity, it places 00h 
(the overrun character) into the bottom of the keyboard 
buffer. When the overrun character reaches the top of the 
buffer, the keyboard sends it to the system. 
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System Commands to the Mouse 


Introduction 


The command D4h, Write to Auxiliary Device, tells the 8042 firmware to 
transmit the next byte it receives to the auxiliary device. All commands 

written to the mouse must therefore be written according to the process 
described below: 


1. D4h, Write to Auxiliary Device, must be written to port 064h. 
2. nnh, the system-to—mouse command, must be written to port O60h. 


Note: Unless it receives D4h in port 064h first, the 8042 firmware will pass 
all commands written to port O60h directly to the keyboard. 


Command list 


RESET SCALING 
Resets scaling 1:1 


SET SCALING 2:1 

This command can only be used when the mouse is in Stream 
Mode. In Stream Mode, the current X/Y coordinate values are 
converted to new values each time the sample period expires. In 
2:1 scaling, the relationship between the input and output values 
is as follows: 


Akh WN—-O 
| 


SET RESOLUTION 
This is a two-—byte command. The second byte written to port 

060h is interpreted as a resolution in counts per mm. There are 
four possible resolutions. The relationship between second byte 
and resolution is listed below: 


1 count per mm 
2 counts per mm 
4 counts per mm 
8 counts per mm 


continued 
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System Commands to the Mouse, Continued 


Command list, cont’d 


STATUS REQUEST 
This command elicits a 3-byte mouse status report. The format 
of the mouse status report is shown below: 


Byte 3 = Sampling Rate, where: 


Bit 7 = Most significant bit 
Bit 0 = Least significant bit 


Byte 2 = Resolution, where: 


Bit 7 = Most significant bit 
BitQ = Least significant bit 


Byte 1 = Mouse Status, where: 


Bit 7 = Reserved 

Bit 6 = 0 Stream mode 
= 1 Remote mode 

0 Disabled 

1 Enabled 

Scaling 1:1 

R 


Scaling 2:1 
eserved 
1 Left mouse button pressed 
= Reserved 
= 1 Right mouse button pressed 


SET STREAM MODE 
In Stream mode, the mouse transmits data to the system each 
time a mouse button is pressed or released, or each time the 
mouse detects a unit of movement. The mouse data sample rate 
determines the maximum number of times per second mouse 
data can be transmitted to the system. If no button is pressed 

or if the mouse is not moved, then no data is transmitted to the 
des The Set Stream Mode command turns the mouse stream 
mode on. 


READ DATA 
The Read Data command forces the transmission of one mouse 
data packet. The Read Data command is valid in both stream 

mode and in remote mode. 


SET WRAP MODE 
This command sets wrap mode, the mouse “echo” mode. With 
the exception of ECh, Reset Wrap Mode, and FFh, Reset Mouse, 
the mouse will echo back all data and commands received from 
the system. 


continued 
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System Commands to the Mouse, Continued 


Command list, cont’d 


SET REMOTE MODE 
In Remote mode, the mouse data can only be transmitted in reply 
to a Read Data command. 


READ DEVICE TYPE 
The mouse ID byte is 00h. The mouse returns 00h in reply to the 
Read Device Command. 


SET SAMPLING RATE 

Sampling Rate is defined as the number of times per second the 
system checks for mouse data. This is a two-byte command. | 
F3h, the Set Sampling Rate command, must be followed by a sec- 
ond byte, representing the hex value of the sample rate. The val- 
ues listed below are allowable sample rates. 


Hex Value (2nd Byte) Sample Rate | 


OAh 10/second 
20/second 
40/second 
60/second 
80/second 

106/second 

200/second 


F4h ENABLE 
Enables data transmissions if the mouse has been set to stream 
mode. Has no effect in remote mode. 


| DISABLE | 
Disables mouse data transmissions if the mouse is in stream 
mode. Has no effect in remote mode. 


SET DEFAULT 
The Set Default command reinitializes the mouse to its power-on 
default state. The mouse power-on default state is as follows: 


Sampling Rate = 100/second 

Scaling = Linear Scaling 
Mode = Stream mode 
Resolution = 4 counts/mm 
= Disabled 


Transmissions 


RESEND 
Errors in transmissions from the mouse cause the system to send 
the Resend command. The mouse responds by retransmitting its 

last data packet. 


RESET 
Reset mode instructs the mouse to run its internal self test rou- 
tine. This command puts the mouse into reset mode. 
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Mouse-to-System Replies 


Reply list 


480 


There are only two mouse-to-system replies. Both replies are related to 
command processing and are read by the system at port O60h. 


Reply Description — 


ACK (Acknowledge) 

The mouse replies with FAh, ACK, anytime it receives a valid 
command from the system. Unlike mouse serial data packets, the 
ACK reply is not stored in a buffer in internal memory, but is dis- 
carded immediately after it Is transmitted. If a new command is 
received while the mouse is in the ACK reply process, the mouse 
discards the ACK reply and begins processing the new command 
immediately. 


Note: The commands ECh, Reset Wrap Mode, and FFh, Reset, 
are exceptions to mouse ACK behavior. The mouse does 
not respond with ACK to either of these commands. 


RESEND | | 
The mouse replies with FEh, Resend, anytime it receives an inva- 
lid command from the system. Two invalid commands in 
succession cause the mouse to send the error code FCh to the 
system. A single, isolated invalid command, however, does not 
affect mouse processing in any way. The mouse simply ignores 
single invalid commands, maintaining its present operational state. 
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Appendix C 


Hardware Environment for 
8086-Based Systems 


Overview 


In this appendix 


This appendix describes the hardware environment needed to implement 
the ROM BIOS on PS/2 systems (e.g. IBM Models 25 and 30) and com- 
patibles based on the 8086 microprocessor. These systems are not 
MCA-compatible. | 


The following topics are discussed: 
=» Hardware Address Locations 

» Microprocessor 

» 8087 Math Coprocessor 

=» System Support Gate Array 

«= |/O Support Gate Array 

» System Time—Related Logic 

» Interrupt Controller Extensions 

«» System Timer 

= DMA Controller 

# 8259 Programmable Interrupt Controller 
« Miscellaneous Additional Logic 
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Hardware Address Locations 


Table: Hardware I/O Port Definitions 
The following table gives the locations of the various I/O ports and their 
functions. 


Note: An x before a bit setting description indicates that this bit setting has 
no meaning when the condition stated after the x is true. 


Read/Write 
I/O Address Status Description 


[000m | RWW | OMA channel 0, memory adress regiter 
[ooo [Rw | DMA cnanne 0, transfer count regiter——_—| 
[00am [Rw | OMA channel 1, memory address roger 
[coos [Rw _| BWA channel, transfer count regitor 
BMA channel 2, anefr oun reg 
008% T-DwA channel 9, memory aaeressreoiter | 


0008h DMA channel 0-3, status register, where: 

Bit 7 = 1 Channel 3 request 
Bit 6 = 1 Channel 2 request 

| Bit 5 = 1 Channel 1 request 

| Bit 4 = 1 Channel 0 request 
Bit 3 = 1 Terminal count on channel 3 
Bit 2 = 1 Terminal count on channel 2 

| Bit 1 = 1 Terminal count on channel 1 
Bit 0 = 1 Terminal count on channel 0 


R/W 
—RIW 
R/W | 
R/W 
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0008h DMA write command, where: 
| Bit 7 = 0 DACK sense active low 

= 1 DACK sense active high 

Bit 6 = 0 DREQ sense active low 
= 1 DREQ sense active high 

Bit 5 = 0 Late write selection 
= 1 Extended write selection 
= x Bit 3 is one 

Bit4 =0 Fixed priority 
= 1 Rotating priority 

Bit 3. =0 Normal timing 
= 1 Compressed timing 
= x Bit 0 is one 

Bit 2 = Q Enable controller 
= 1 Disable controller 

Bit 1 = Q Disable channel 0 address hold 
= 1 Enable channel 0 address hold 
= x Bit 0 is zero 

Bit 0 = 0 Disable memory to memory 
= 1 Enable memory to memory 


continued 


Hardware Address Locations, Continued 


Table: Hardware 1/O Port Definitions, cont’d 


Read/Write 
1/O Address Status Description 


DMA request register, where: 


Bits 7-3= x Reserved 

Bit 2 0 Reset request bit 

1 Set request bit 

Bits 1-O0= 00b Select channel 0 
= 01b Select channel 1 
= 10b Select channel 2 

= 11b Select channel 3 


DMA single mask register, where: 


Bits 7-3= x Reserved 

Bit 2 = 0 Clear mask bit 

Bits 1-O= 00b Select channel 0 mask bit 
= 01b Select channel 1 mask bit 
= 10b Select channel 2 mask bit 
= 11b Select channel 3 mask bit 


DMA mode register, where: 
Bits 7-6= 00b Demand mode select 


11b Cascade mode select 


Bit 5 = 0 Address increment select 
= 1 Address decrement select 
Bit 4 = 0 Disable auto initialization 
= 1 Enable auto initialization 
Bits 3-2= 00b Verify transfer 


O1b Write transfer 

= 10b Read transfer 

= 11b Illegal value 

= xx if Bits 7 and 6 on 
Bits 1-O= 00b Select channel 0 
' =01b Select channel 1 
= 10b Select channel 2 
= 11b Select channel 3 


DMA clear byte pointer. Sets a low byte/high byte 
flip-flop for the dual read/write ports to a known 
state, where the next access will be to the low 
byte register. 


DMA read temporary register. Holds data during 
memory-to-memory transfers. 


DMA master clear (Resets the 8237. The com- 
mand, status, request, temporary, and internal 
first/last flip-flop registers are cleared, and the 
ee is set. The 8237 is In the idle 
state). 


WwW DMA clear mask register (Clears all four channel 
~ masks so they can accept DMA requests) 


continued 
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Hardware Address Locations, Continued 


Table: Hardware I/O Port Definitions, cont’d 


Read/Write 
1/O Address Status Description | 


O00OFh W DMA write all mask register bits, where: 
Bits 7-4= x Reserved 
Bit 3 = 0 Clear channel 0 mask bit 
= 1 Set channel 0 mask bit 
Bit 2 = 0 Clear channel 1 mask bit 
= 1 Set channel 1 mask bit 
Bit 1 = 0 Clear channel 2 mask bit 
= 1 Set channel 2 mask bit 
Bit 0 = 0 Clear channel 3 mask bit 
| | = 1 Set channel 3 mask bit 


PIC Interrupt request/In-service registers pro- 
grammed by Operation Command Word 3 (OCWS): 


Interrupt request register, where: 


Bits 7-O= 0 No active request for the correspon- 
ing interrupt line 
= 1 Active request for the corresponding 
interrupt line 


Interrupt in-service register, where: 


Bits 7-O= 0 The corresponding interrupt line is not 
currently being serviced 
= 1 The corresponding interrupt line is 
currently being serviced 


PIC Initialization Command Word 1 (ICW1) (Bit 4 is 
one), where: 


Bits 7-5= 000 Only used in 80/85 mode 


Bit4 =1 Reserved 
Bit3 =0 Edge triggered mode 
= 1 Level triggered mode 
Bit2 =0 Successive interrupt vectors are 
separated by eight bytes 
= 1 Successive interrupt vectors are 
separated by four bytes 
Bit 1 = 0 Cascade mode 
= 1 Single mode - no ICW3 needed 
BitO =0 No ICW4 needed 
= 1 ICW4 needed 


PIC ICW2, ICW3, or ICW4 in sequential order after 
ICW1 written to Port 0020h 


IiCW2, where: 


Bits 7-3 = Address lines AO-A3 of base vector 
address for interrupt controller 
Bits 2-0 = 000 Reserved 


continued 
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Hardware Address Locations, Continued 


Table: Hardware I/O Port Definitions, cont’d 


Read/Write 
1/O Address Status Description 


0021h 
(cont’ d) 


PIC ICW3, where: 


Bits 7-O= 0 Slave controller not attached to 


corresponding interrupt pin 
= 0 Slave controller attached to 
corresponding interrupt pin 


iCW4, where: 


Bits 7-5= 000 Reserved 
Bit 4 = 0 No special fully-nested mode 
= 1 Special fully-nested mode 
Bits 3-2= 00 Nonbuffered mode 
= 01 Nonbuffered mode 
= 10 Buffered mode/slave 
= 11 Buffered mode/master 
0 Normal EOI 
1 Auto EOI 
0 80/85 mode 
1 8086/8088 mode 


PIC Interrupt mask register (OCW1), where: 


Bit 7 
Bit 6 
Bit 5 
Bit 4 
Bit 3 
Bit 2 
Bit 1 


Bit 0 


Enable parallel printer interrupt 
Enable diskette interrupt 
Enable fixed disk interrupt 
Enable serial interrupt 
Reserved 

Enable video interrupt 


oOo oooo°odcoe 


interrupt 
Enable timer interrupt 


PIC OCW2 (Bit 4 is zero, Bit 3 is zero), where: 
Bits 7-5 = 000 Rotate in automatic EOI mode 
| 


clear) 
001 Nonspecific EO! 
010 No operation 
: 1 Specific EOI 
1 


1 Rotate on nonspecific EOI 
command 
0 Set priority command 


1 
1 
0 Reserved 
0 Reserved 


| 
plies 


ae] 


1 
11 Rotate on specific EOI command 


Enable keyboard/pointing device/RTC 


1 
a Rotate in automatic EOI mode (set) 


nterrupt request to which the command 


continued 
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Hardware Address Locations, Continued 


Table: Hardware I/O Port Definitions, cont'd 


Read/Write 
1/O Address Status Description 
W PIC OCW3 (Bit 4 Is zero, Bit 3 is one), where: 
Bit7 =0O Reserved 

Bits 6~5= 00No operation 
R/W System timer counter 0 (Current 16-bit count for 
timer 0) 
0041h System timer counter 1 (Current 16-bit count for 
timer 1) 
System timer counter 2 (Current 16-bit count for 
timer 2) 


1No operation 
R/W 
R/W 
0043h WwW System timer control register, where: 
Bits 7-6 = 00 Select counter 0 
= 01 Select counter 1 
= 10 Select counter 2 
= 11 Illegal 
Bits 5-4 = 00 Counter latching operation 
= 01 Read/load least significant byte only 
= 10 Read/load most significant byte only 
= 11 Read/load least significant byte, 
then most significant byte 
Bits 3-1 = 000 Mode 0 
| 001 Mode 1 
x10 Mode 2 
x11 Mode 3 
| 100 Mode 4 
101 Mode 5 
Bit 0 0 Binary counter (16 bits) 
1 BCD counter (four digits) 


Bit 4 
Bit 3 Reserved 
Bit 2 No poll command 


= 1 Poll command 
Bits 1-O= 00No operation 
= 01No operation 
= 10 Read interrupt request register on 
next read at Port 0020h 
= 11 Read Interrupt in-service register on 
next read at Port 0020h 


0 Reset special mask 
1 Set special mask 
0060h Keyboard/Pointing device output buffer 


0 
1 
1 
° Reserved 
0 
continued 
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Hardware Address Locations, Continued 


Table: Hardware I/O Port Definitions, cont’d 


Read/Write 
1/0 Address Status Description 


System control ee where: 


Bit 7 Reserved 

Reserved 

Enable |/O channel check 
Enable RAM parity check 
Reserved 

Reserved 

Beeper data 

Enable timer 2 gate to speaker 


x 


—xxxKOOX 


board status, where: 


Parity error occurred 
1/O channel check active 
Timer 2 output status 
Reserved 

Reserved 

Disk installed 
Coprocessor installed 
Reserved 


Hou Ww Ht Wa al 
x A OK KK 


Software vector number, where: 


| Bits 7-3= Software vector number of interrupt 
vector for hardware interrupt 1 
minus one 


R/W Planar control register, where: 

Enable parallel port output 

i Reserved 

Reserved 

Select serial chip 

Select diskette chip 
Select video chip 
Select parallel port chip 
Select fixed disk chip 


Keyboard/pointing device control port 1, where: 


= Q Enable keyboard/pointing device 
command start 

= 0/1/0 System ready for keyboard/auxil- 
lary data 

= 0 Enable keyboard/auxiliary command 
start 


a et od ot tt OO 


= 0/1/0 System ready for keyboard/point- 
ing device data 
Keyboard/pointing device attached to 


Keyboard unlocked 
Keyboard locked 

Port 0068h enabled 
Port 0067h enabled 


nnnn Qu 
OOoO-o0>- 


continued 
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Hardware Address Locations, Continued 


Table: Hardware 1|/O Port Definitions, cont'd 


Read/Write 
1/O Address Status Device Description 


0067h Device 2 data port (data from keyboard input here) 
0067h Device 2 command port 
0068h Device 1 data port (data from mouse come here) 


Undefined system port, where: 


Bits 7-6= 00 Reserved 

Bit5 =1 Device 0 data ready 
Bits 4-3= 00 Reserved 

Bit2 =1 Device 1 data ready 
Bit 1 = Reserved 

Bit 0 = x Diskette related to rate 


Planar RAM control/status register, where: 


Bit 7 = 0 Upper 512K failed (Parity check 
pointer) 
Lower 128K failed 


= 1 

Bit6 =1 Enable RAM, 90000h - SFFFFh 
Bit5 =1 Enable RAM, 80000h - 8FFFFh 
Bit4 =1 Enable RAM, 70000h - 7FFFFh 
Bit3 = 1 Enable RAM, 60000h - 6FFFFh 
Bit2 =1 Enable RAM, 50000h - SFFFFh 
Bit 1 = 1 Enable RAM, 40000h - 4FFFFh 
BitO | =1 Remap low memory . 


Reserved 


0068h Device 1 command port (commands to the mouse 
sent from here) 
start 
Bit 3 = |/O pointing device/ keyboard command 
006Ch-0076h 
0077h Undefined system port 
0082h DMA page register channel 1 


0069h W Device 1 and 2 control port 2, where: 
Bits 7-5 = x Reserved 
Bit 4 = I/O pointing device/keyboard command 
start 
Bit 2 = 1 POST completion 
Bit 1-O = Reserved 
- 
; 
0080h DMA page register channel 2 
0081h DMA page register channel 3 
0087h DMA page register channel 0 
continued 
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Hardware Address Locations, Continued 


Table: Hardware !|/O Port Definitions, cont’d 


Read/Write 
1/O Address Address Description 


oossn-oosth | | Reserved 


0090h R/W Manufacturing port register (flags various stages 
of POST testing in progress) 


OOA0h Interrupt controller extension request register, 

where: 
Bit7 =1 Enable NMI 

= 0 Disable NMI 
Bits 6-4= x Reserved 
Bit 3 = 1 Device 1 (Port 0068h) interrupt 
Bit 2 = 1 Device 0 (Port 0067h) interrupt 
Bits 1-O= Reserved 


Interrupt controller extension mask register, 
where: 


Bits 7-1= Reserved 
Bit 0 = 1 Enable mask for RTC alarm interrupt 


Reserved 


Real time clock alarm clear register (clears the 
alarm interrupt condition of the clock chip when 
read) 


— 


00A2h-—00AFh 


0OBOh 
OOBth 


00B2h 


0OB3h 


Real time clock alarm enable register, where: 


Bits 7-1= x Reserved 
Bit 0 = 1 Alarm enabled 


Reserved 


Real time clock enable register, where: 
FFh = Enable clock operation 


Real time clock status register, where: 


Bits 7-1= 0 Reserved 
Bit 0 = 1 Clock update in progress 


Reserved 


Real time clock 100 microsecond counter, where: 


Bits 7-4= 100 microsecond count in BCD 
Bits 3-O= 0 Reserved 


OOBSh-O00DFh 


OOEth Real time clock millisecond counter, where: 


Bits 7-4= 1 100 millisecond counter in BCD 
Bits 3-O= 0 10 millisecond counter in BCD 


Real time clock seconds register (in BCD) 


continued 
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Hardware Address Locations, Continued 


Table: Hardware |/O Port Definitions, cont’d 


490 


Read/Write 
1/O Address Status Device Description 


| ooesh | Rw Real time clock minutes register (in BCD 


00E4h me Real time clock hours register (in BCD) 


Real time clock day of week (not used by the 
BIOS), where: 


Bits 7-3= 0 Reserved 
Bits 2-O= Day of week 


i time clock day register (day of the month in 
CD) 


Real time clock month register (in BCD) 


Real time clock month encode register 1 


Bit 7 = 1 Reserved 

Bit 6 = 1 Reserved 

Bit 5 = Encoded month (bit 3) 
Bit 4 = Encoded month (bit 2) 
Bits 3-O0= 0000 Reserved 


Real time clock year register. Year (module 100) 
in BCD format. 


Real time clock alarm seconds register (alarm 
time in seconds in BCD; set to FFh when alarm is 
not set) 


OOEBh Real time clock alarm minutes register (alarm time 
in minutes in BCD; set to FFh when alarm is not 
set) 


00E7h 
OOE8h 


OOEAh 


OOECh Real time clock alarm hours register (alarm time 
In hours in BCD; set to FFh when alarm is not 


set) 


Real time clock month encode register 2, where: 


Bit 7 = 1 Reserved 
Bit 6 = 1 Reserved 
Bit 5 = 0 Reserved 
Bit 4 = 0 Reserved 
Bit 3 = 0 Reserved 
Bit 2 =.0 Reserved 
Bit 1 = Encoded month (bit 1) 
Bit 0 |= Encoded month (bit 0) 


continued 
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Hardware Address Locations, Continued 


Table: Hardware I/O Port Definitions, cont’d 


Real Time Clock checksum register 1, where: 


Bit 7 = 1 Reserved 

Bit 6 = 1 Reserved 

Bit 5 = 1 Bit 5 of checksum 

Bit 4 = 1 Bit 4 of checksum Inverted 
Bit 3 = 1 Reserved 

Bit 2 = 1 Reserved 

Bit 1 = 0 Reserved 

Bit 0 = : 21st century 


20th century 


Real Time Clock checksum register 2, where: 


Bit 7 = 1 Reserved 

Bit 6 = 1 Reserved 

Bit 5 = Bit 3 of checksum Inverted 
Bit 4 = Bit 2 of checksum 

Bit3 =1 Reserved : 

Bit 2 = 1 Reserved 

Bit 1 = Bit 1 of checksum 

Bit 0 = Bit 0 of checksum inverted 


OOFFh Undefined system port 
o100h-0277h_| | CReserved 


aren [ nw] Para eontol por (see oarany +f 
ae Kea 
[| -Adeotr torre register ever? 
(| -Aseoer ntrruptregeerievers 
[raster rtorupt regitor vel 
oars |__| Acer intrrptregsterievels 
es 
———, 
— 
anne 
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Hardware Address Locations, Continued 


Table: Hardware I/O Port Definitions, cont’d 


Read/Write 
1/O Address Status Description 


0322h W Fixed disk adapter control register, where: 
Bit 7 Reset 
Bit 6 Reserved (except during reset) 
Bit 5 Force 8-bit programmed !/O (PIO) 
mode 
Bit 4 Reserved 
Bit 3 Reserved 
Bit 2 Force 8-bit PlO mode 
Bit 1 Interrupt through adapter status 
register (324) 
| = 1 Interrupt through programmable 
interrupt controller 
Bit O = 0 Programmed I/O (PIO) mode 
= 1 DMA mode 


ooooeo OoO-— 


0322h Fixed disk adapter status register, where: 
Bit 7 = 0 Reserved 
Bit 6 = 0 Reserved 
Bit 5 = 0 Force 8-bit PIO mode 
Bit 4 = 1 Data transfer requested by adapter 
| Bit 3 = Q Data direction is system to adapter 
= 1 Data direction is adapter to system 
Bit 2 = 1 Adapter busy 
Bit 1 = 1 Interrupt occurred flag — 
BitO =1 Transfer in progress 


0324h WwW Fixed disk adapter attention register, where: 
Bit 7 = 1 System request to send CCB (com- 
mand control block) 
Bit 6 = 0 Reserved 
Bit 5 = 1 System request to send sense sum- 
mary block 

Bit 4 = 1 Data transfer requested by system 
Bit 3 = 0 Reserved 
Bit 2 = 0 Reserved (Select drive 0) 

| Bit 1 = 0 Reserved 
Bit 0 = Q Abort current command 

0324h Fixed disk adapter interrupt status register, where: 
Bit 7 =1 Termination error, error in bits 6-0 
Bit 6 = 1 Invalid command 
BitS = 1 Command reject 
Bit 4 = 0 Reserved 
Bit 3 = 0 Reserved 
Bit 2 = Q Reserved (Select drive 0) 
Bit 1 = 1 Error recovery procedure invoked 
Bit 0 = 1 Equipment check 
) 0378h Parallel 2 data port 


continued 
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Hardware Address Locations, Continued 


Table: Hardware 1/O Port Definitions, cont’d 


1/O Address 


0379h 
037Ah 


[sep 
[aac 


Read/Write 
Status 


Bit 7 
Bit 6 
Bit 5 
Bit 4 
Bit 3 
Bit 2 
Bit 1 
Bit 0 


ooo0o+_ $+ & & 


Bits 7-6= 0 
Bit 5 


Bit 4 
Bit 3 
Bit 2 
Bit 1 
Bit 0 


eh ah CS wed oth oe 


wou ww tk wel 
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Description 


Parallel 2 status port, where: 


Parallel 2, control port, where: 


Other VGA sequencer registers 
Video DAC PEL mask 


Busy 
Acknowledge 
Out of paper 
Printer selected 
Error 

IRQ occurred 
Reserved 
Reserved 


Reserved 

Direction is write to port 
Direction is read to port 
Enable IRQ 

Select printer 

Initialize printer 
Automatic line feed 
Strobe 


continued 
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Hardware Address Locations, Continued 


Table: Hardware I/O Port Definitions, cont’d 


Read/Write 
1/O Address Status Description 


03C7h Video DAC PEL address, read mode 
03C7h FR Video DAC state register 
03C8h Video DAC PEL address, write mode 
03C9h R/W Video DAC PEL data register 

iW 


_ RW 
| scan | R VGA feature control register 
[escch |__| _VGArmiscelaneous output register 


— 03D4h VGA CRT controller index register, where: 


Bits 7-6= Reserved 
O3D6h-03D7h 
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Bit 5 = Index5 
Bit 4 = Index4 
Bit 3 = Index3 
Bit 2 = Index2 
Bit 1 = Index 


Bit 0 = Index0 


VGA Data register 
VGA registers 


CGA mode control register, where: 


Bit 7 = 0 Reserved 
Bit 6 = 0 Reserved 
Bit 5 = 0 No blink 
= 1 Blink 
Bit 4 = 1 Mode 6, 640 x 200 
Bit3 = 1 Enable display image 
Bit 2 = Q Palette address 00h and CGA border 
register select color 
= 1 Palette address 00h-07h are the two 


colors selected 

Select mode 4 and 5, 320 x 200 
Select 80 x 25 mode 
CGA border control register, where: 
Bit7 =0 Reserved 


Bit6é =0 Reserved 
BitS5 = 320 x 200 palette select 
Bit4 = _ Alternate intensity 


Bits 3-0 - Border color 


continued 


Hardware Address Locations, Continued 


Table: Hardware I/O Port Definitions, cont’d 


Read/Write 
Address Status Description 


Reserved 


Vertical sync 
Reserved 
Reserved 


O3DAh VGA status register, where: 
Display enable 


VGA extended mode control, where: 


. Bit 7 


Bits 6-3 


Bit 2 
Bit 1 


0 
0 


Readable DAC installed 
Reserved 

256 colors 

Reserved 


Bit 0 


0 


Reserved 


O3FOh Diskette controller port A register, where: 

Bit 7 

| Bit 6 
Bit 5 
Bit 4 k O 
Bit 3 
Bit 2 
Bit 1 
Bit 0 Direction 


Diskette controller port B register, where: 


Bit 7 
Bit 6 
Bit 5 
Bit 4 
Bit 3 
Bit 2 
Bit 1 
Bit 0 


—=t§ OOO =| = © 


OOo a | aA at © = 


Interrupt pending 
Second drive installed 
Step (latched) 

Trac 

Head 1 selected 
Index 

Write protect 


Reserved 

Select drive 1 

Select drive 0 

Write data (latched) 
Read data (latched) 
Write enable (latched) 
Select drive 3 

Select drive 2 


Diskette controller digital output register, where: 


Bit 7 
Bit 6 
Bit 5 
Bit 4 
Bit 3 
Bit 2 


= 0 Enable motor drive 3 

= 0 Enable motor drive 2 

= 0 Enable motor drive 1 

= 0 Enable motor drive 0 

= 0 Enable DMA and interrupt 
= 1 Reset controller 

Bits 1-O= 00 Select drive 0 


0 
1 
1 


1 Select drive 1 
0 Select drive 2 
1 Select drive 3 


continued 
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495 


Hardware Address Locations, Continued 


Table: Hardware I/O Port Definitions, cont'd 


496 


Read/Write 
1/O Address | Status Description 


03F4h Diskette main status register, where: 
Bit 7 = Request for master 
Bit6é = Stat input/output 
BitS5 = Non-DMA mode 
Bit4 = Diskette controller busy 
Bit 3,2 = Reserved 
Bit 1 = Drive 1 busy 
BitO = _ Drive 0 busy 


O3F 5h | Diskette controller data registers 


03F7h Diskette controller digital input register, where: 


Bit 7 = Diskette change 

Bits 6-4 = Reserved 

Bit 3 = DMA enable 

Bit 2 = No write precompensation 
Bit 1 = Select 250 rate 


Bit 0 


Diskette controller configuration control register, 
where: 


Bits 7-3 = Reserved 


= Reserved 


Bit 2 = No write precompensation 
Bit 1 = 0 500 Kbs mode 
= 1 250 Kbs mode 


Bit 0 

Serial register 1, transmitter holding register, 

where: 

Bits 7-0 = Data bits 7 through 0, respectively, 
when Divisor Latch Access Bit 

(DLAB 

Serial register 1, receiver buffer register, where: 

Bits 7-0 = Data bits 7-0, respectively, when 
DLAB = 0 


= Reserved 


Serial register 1, divisor latch, low byte, where: 
Bits 7-0 = Bits 7-0 of the divisor when DLAB = 1 


Serial register 1, divisor latch, high byte, where: 
Bits 7-0 = Bits 15-8 of the divisor when DLAB = 1 


continued 
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Hardware Address Locations, Continued 


Table: Hardware I/O Port Definitions, cont’d 


Read/Write 
I1/O Address Status Description 


O3F9h Serial register 1, interrupt enable register, where: 


Bits 7-4 = 0 Reserved 

Bit 3 = 1 Enable modem status interrupt 

Bit 2 = 1 Enable receiver line status interrupt 

Bit 1 = 1 Enable transmitter holding register 
empty interrupt 

Bit 0 = 1 Enable received data available inter- 
rupt when DLAB = 0 


O3FAh Serial register 1, interrupt identification register, 
where: 
Bits 7-3 = 0 Reserved 
Bits 2-1 = 00 Modem status interrupt 
= 01 Transmitter holding register empty 
interrupt 
= 10 Received data available register 
interrupt 
= 11 Receiver line status interrupt 
Bit 0 = 0 Interrupt pending 


O3FBh R/W Serial register 1, line control register, where: 


Bit 7 = 1 Divisor latch access 

= 0 Receiver buffer, transmitter holding or 
enable registers access 

Bit6 = 1 Set break enabled 

Bit5 = 1 Stick parity, if parity is enabled 

Bit 4 = 1 Even parity select, if parity is enabled 

Bit 3 = 1 Parity enable 

Bit2 =0 1 stop bit is specified if word length >5 
= 1 2 stop bits are specified if word length 


> 5; 1.5 stop bits are specified if word 
length = 5 
Bit 1-0 = 00b Word length is 5 bits 
= 01b Word length is 6 bits 
= 10b Word length is 7 bits 
= 11b Word length is 8 bits 


O3FCh R/W 


Serial register 1, modem control register, where: 


Bit 7-5 =0 Reserved 

Bit 4 loop back mode 

Bit 3 Enable OUT2 interrupt 

Bit 2 Force OUT1 active 

Bit 1 Force request-to-send active 

Bit 0 Force data-terminal-ready active 


Hou uw wou 
—) ok sk ss os 
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Hardware Address Locations, Continued 


Table: Hardware 1/O Port Definitions, cont’d 


498 


Bit 7 
Bit 6 
Bit 5 
Bit 4 
Bit 3 
Bit 2 
Bit 1 
Bit 0 


; _ 


Read/Write 
1/O Address Status Description 


O03FDh | Serial register 1, Line status register, where: 

Bit7 = 

Bit6 = 

pty 

Bit 5 1 

Bit 4 1 

Bit 3 1 

Bit 2 1 

Bit 1 1 

Bit 0 1 Data ready 


Serial register 1, modem status register, where: 


eee, eet, eth eh ee eh ah oh 


O3FFh Serial register 1, scratch register 


Reserved 

Transmitter shift and holding registers 
empt 

Transmitter holding register empty 
Break interrupt 

Framing error 

Parity error 

Overrun error 


Data carrier detect 

Ring indicator 

Data set ready 

Clear to send 

Delta data carrier detect 
Trailing edge ring indicator 
Delta data set ready 
Delta clear to send 
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Microprocessor 


Requirement 


The 8086 PS/2 BIOS must be implemented in a system that uses the Intel 
8086-2 or an equivalent microprocessor. 


Processor speeds supported 


The 8086 PS/2 BIOS supports microprocessor speeds of from 4.77 to 
10 MHz. 


Wait states supported 
The 8086 PS/2 BIOS supports either zero or one wait state. 


Address modes 


The 8086 PS/2 BIOS supports real address mode only. Real address mode 
supports 20-bit addresses, made up of 16-bit segments and 4-bit offsets, 
with a maximum addressable memory area of 1 MB. All segments are 64K. 
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8087 Math Coprocessor 


introduction 


The 8086 PS/2 BIOS can be implemented in systems that include an Intel 
8087 math coprocessor or its equivalent. 


Description 


The 8087 math coprocessor performs high speed arithmetic, logarithmic, 
and trigonometric floating point arithmetic calculations. This permits much 
speedier processing for mathematically—intensive processing applications. 


The math coprocessor works in parallel with the microprocessor, allowing 
both to process instructions separately. See the user manual for the Intel 
8087 math coprocessor for details about the extended data types, registers, 
and instructions available with this chip. 


Math coprocessor hardware interface 


The coprocessor operates in an asynchronous mode and can use the same 
clock generator as the microprocessor. It functions as an |/O device and its 
presence is indicated if Bit 1 of port 0062h is on. 


The coprocessor BUSY signal tells the microprocessor that the coprocessor 
is operating. The WAIT signal means that it is executing and forces the 
microprocessor to wait until the coprocessor is done. 


The coprocessor operates in the real address mode. 
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System Support Gate Array 


Gate array contents 
A system such as the PS/2 Model 30 and compatibles has a system support 
gate array. The system support gate array contains the following: 
= a bus controller, 
=" a memory controller and parity checker, 
=» bus conversion logic, 
= a wait-state generator, and 
» a system clock generator. 


Bus controller 


The 8086 PS/2 BIOS supports a bus controller that has three bus masters. 
The bus masters are: 


= a microprocessor master 
=" a coprocessor master, and 
» a system support gate array bus master. 


The 8086 PS/2 BIOS supports the XT I/O bus, so all XT-compatible add-on 
boards are supported. 


Memory controller 


The 8086 PS/2 BIOS supports a memory controller/parity checker function. 


Bus conversion logic 


The system support gate array also contains bus conversion logic and a 
wait-state generator. 


System clock generator 


The system support gate array contains the system clock function. The 8086 


PS/2 BIOS expects an Intel 82284 clock generator chip, or equivalent chip, to 
be available. | 
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/O Support Gate Array 


I/O support 
The 8086 PS/2 BIOS I/O support function includes support of all of the follow- 
ing I/O features and capabilities: 
= a serial port 
= a parallel port 
= a diskette controller 
= a fixed disk controller, and 
=» a VGA video controller. 


Each of these capabilities is discussed in the following sections. 


Serial port 


The 8086 PS/2 BIOS supports either a National Semiconductor 16550 serial 
port controller, or equivalent logic. The serial port can be addressed as 
Serial 1 or Serial 2. IRQ 4 is the line for Serial 1 and IRQ 3 for Serial 2. The 
serial ports are at I/O port addresses O3F8h and O2F8h. 


NS16550 characteristics 
The NS16550 supports: 
» Characters of 5, 6, 7, or 8 bits, 
» 1, 1.5, or 2 stop bits, and 
= even, Odd, or no parity modes. 


Note: The NS16550 is functionally compatible with the NS16450 and the 
NS8250. 


Programmable baud rate generator 


The serial port controller can operate at speeds of from 110 to 19,200 bps. 


continued 
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I/O Support Gate Array, Continued 


Parallel port 


The 8086 PS/2 BIOS supports a parallel port that can transfer 8 bits of data 
at standard TTL levels. The parallel port can be called port 1, 2, or 3, is 
AT-compatible, and has a bidirectional mode, Supporting both input and 
output. It also supports level sensitive interrupts and a readable interrupt 
pending status. 


Parallel port addresses 


The following table lists the parallel port addresses: 


Parallel Data Status Control 
Port Number Address Address Address 


Diskette controller 


The 8086 PS/2 BIOS supports an NEC 765, or equivalent diskette controller. 
Diskette support from other PS/2 BIOS products may exist only for 720K 3.5 
inch diskette drives. Four types of diskette drives are supported by the 
Phoenix 8086 PS/2 BIOS: 

»® 720K 3.5 inch, 

=» 1.44 MB 3.5 inch, 

» 360K 5.25 inch, and 

= 1.2 MB 5.25 inch drives. 


The Phoenix 8086 PS/2 BIOS also will work with a system with no diskette 
drives, as long as the BIOS options are configured to support the configura- 
tion error message suppression option. 


continued 


Hardware Environment for 8086-Based Systems 503 


/(O Support Gate Array, Continued 


Diskette drive configuration | 
The IBM PS/2 8086 BIOS supports one or two internal diskette drives. 


The Phoenix 8086 PS/2 BIOS supports up to two internal diskette drives and 
one external diskette drive. These drives can be any combination of zero, 
one or two internal diskette drives (which can be a mix of any supported 
drive types), and one external drive (must be a 3.5 inch drive). 


Fixed disk controller 


The 8086 PS/2 BIOS supports zero, one, or two fixed disks. The BIOS 
assumes that a Western Digital ST506 fixed disk controller, or equivalent, 
is available. 


Fixed disk 1/O channels 


The 8086 PS/2 BIOS supports a dedicated I/O channel for fixed disk support 
at I/O address 0320h. The fixed disk adapter status register and control 

registers are at I/O address 0322h, the fixed disk adapter attention register 
is at 0324h, and the fixed disk adapter interrupt status register is at 0324h. 


The DMA controller is programmed to perform the read/write fixed disk 
functions. DMA channel three is used for fixed disk data transfers. The 
system board controls the chip select feature of the fixed disk controller 
through the Planar Control Register (Port OO65h). 


Video controller 


The Phoenix 8086 PS/2 BIOS supports the Video Graphics Array (VGA) 
controller. The IBM 8086 PS/2 BIOS supports the MCGA standard. 


continued 
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I/O Support Gate Array, Continued 


DAC 


The video DAC (digital-to-analog converter chip) contains 256 individual 
color registers which can be accessed by the BIOS as either four 64—color 
registers or sixteen 16-color registers. 


Each DAC color register contains one 18-bit RGB (red—green-blue) analog 
value. Six bits of each register are allocated to each primary color. Thus, 
the color represented in each DAC color register may be any of 256K possi- 
ble colors (i.e. 25" = 256K). 


Video RAM 


The Video Service requires 256K of read/write video RAM formatted into four 
banks (or maps) of 64K each. 


To maintain compatibility, display memory for each of the historical MDA, 
CGA, and EGA modes is exactly as it was before. The display memory 
organization for the new VGA modes is outlined in the INT 10h Video Ser- 
vice Section. 


Analog monitor support 


To display all modes, the Video Service requires either a monochrome or a 
color direct drive analog monitor with a 31.5 KHz horizontal scan frequency. 


The display’s vertical gain is adjusted automatically by the VGA-compatible 
circuitry. Thus, video modes with 350, 400, and 480 horizontal scan lines 
can be displayed without requiring manual adjustment. 


Multiscan monitor support 


In addition to 31.5 KHz direct drive analog monitors, the Video Service also 
supports multiscan rate monitors capable of operating in analog modes (e.g. 
NEC Multisync monitor). Monitors of this type require an adapter cable that 
matches the signal assignments and monitor ID circuitry of the DAC external 
video controller. 


continued 
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/O Support Gate Array, Continued 


Keyboard controller 


The 8086 PS/2 BIOS supports an intelligent Keyboard subsystem which is 
referred to as the keyboard support hardware in this book. 


Pointing device interface 


The pointing device in the 8086 PS/2 BIOS is controlled by the keyboard 
support hardware. INT 73h handles interrupts from the pointing device. The 
INT 15h pointing device services control the device operations. 
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System Time-Related Logic 


Chip requirements 


The 8086 PS/2 BIOS expects the following time-handling chips or their 
equivalents to be available: 


= Intel 82284 Clock Generator 
» Intel 8254A Programmable Timer 


» Real time clock (described later in the Interrupt Controller Extensions 
discussion). 


Intel 82284 Clock Generator 


The 8086 PS/2 BIOS expects an Intel 82284 clock generator chip, or equiva- 
lent chip, to be available. 


8254A Programmable Timer 


The 8086 PS/2 BIOS expects an Intel 8254A Programmable Timer chip, or 
equivalent, to be available. The 8254A Programmable Timer is a counter and 
timer that provides three channel timers. All channels are driven by a 1.19 
MHz oscillator signal. 

Timer Counters 

There are some differences between the three timer channels: 


Counters O and 2 are: 


=» independent 16-bit counters, 

= can be preset, and 

# can count in BCD (binary coded decimal) or in binary. 
Counter 3 is: 

» 8 bits only, 

= can be preset, 

* counts in binary only, and 

= can count only downward. 
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Interrupt Controller Extensions 


The 8086 PS/2 BIOS assumes the existence of the interrupt controller exten- 
sion feature, which controls the: 


=» keyboard, 
=" pointing device, and 
= real time clock interfaces. 


See the INT 15h System Services section for a discussion of the interrupt 
controller extension. 


Keyboard subsystem 


The 8086 PS/2 BIOS supports a keyboard subsystem. 101-key keyboards are 
supported. 


Pointing device interface 


The pointing device (mouse) is controlled by INT 71h, which determines 
whether an interrupt is a keyboard, pointing device, or RTC interrupt. 


INT 73h handles all interrupts from pointing devices. The INT 15h pointing 
devices functions control the mouse operation. 


Real Time Clock 


The 8086 PS/2 BIOS assumes a Real Time Clock function that is controlled 
by the interaction of I/O ports OOBOh — OOEFh. The ROM BIOS assumes that 
no CMOS RAM is available in systems based on the 8086. 
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System Timer 


Chip requirements 


The 8086 PS/2 BIOS expects an Intel 8253 Programmable Timer chip, or 
equivalent, to be available. The 8253 Programmable Timer is a counter and 
timer that works as an arrangement of four 16-bit [/O ports at addresses 
0040h-0043h. The 1.19 MHz clock signal is received from the |/O support 
gate array. Ports 0040h-0042h are counters, arid 0043h is a control register 
for timer mode programming. 


Timer Channels 
There are some differences between the three timer channels: 
Channel 0: 
= is a general-purpose timer, 


= provides a constant time base for a time-of-day clock, and 
= can count in binary coded decimal or in binary. 


Channel 1: 

= is for internal diagnostics, 
= can be preset, 

= counts in binary only, and 
=" can count only downward. 
Channel 2: 

= used for tone generation, 


= Outputs to the beeper data of the I/O support gate array, and 
= is controlled by Bit O of port OO6th. 


continued 
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System Timer, Continued 


System timer modes 


The system timer has six modes. These modes are described in the follow- 
ing table: 


a ae Interrupt on Terminal Count 
ai ar Hardware Retriggerable One-Shot 


Software-Triggered Strobe 


Hardware Retriggerable Strobe | 


Common timer mode operations 
All modes have the following operations in common: 
# All control logic resets when control bytes are written to a counter. 
=» Counters do not stop when they reach zero. 


» In Modes O, 1, 4, and 5 the counter wraps to the highest possible count, 
and continues to count. 


=» In Modes 2 and 3, the counter reloads the initial count and continues 
to count. 
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DMA Controller 


DMA requirements 


The 8086 PS/2 BIOS expects the DMA controller to be compatible with an 
Intel 8237, or equivalent controller. It is also expected that the DMA control- 
ler is capable of 8-bit wide data access between 8-bit |/O adapters and 
8-bit system memory. The Direct Memory Access (DMA) controller allows 
I/O devices to transfer data directly to and from memory, significantly de- 
creasing |/O processing by the microprocessor. 


The 8086 PS/2 BIOS supports one 8237 DMA controller, supporting 4 chan- 
nels (channels 0-3), each capable of 20-bit wide data access, operating at 
4 MHz, and uses I/O port addresses O000h to OO1Fh. 


Microprocessor access to DMA 


The microprocessor can address the DMA controller and access the DMA 
registers. The microprocessor can control the DMA modes, transfer ad- 
dresses, transfer counts, channel masks, and page registers. 

On a 10 MHz system, the DMA controller requires 


=» 1 wait state to complete processing of any command from the system, 
«= at least three clock cycles to complete an I/O read or write transfer, and 
= at least two clock cycles for a memory read or write transfer. 


The system microprocessor must access the DMA with 8-bit I/O instructions. 


DMA data transfer 


After the DMA controller is programmed to service a data transfer request, a 
transfer can take place. Channels 0-3 are 8-bits wide and can transfer up to 
64K to/from any address in system memory. DMA transfers take six clock 
cycles of 250ns each, or 1.5 microseconds. More wait states may be added 
for slower devices by making the I/O channel inactive. 
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DMA Controller, Continued 


DMA page registers 
The following table shows the DMA page register characteristics: 


1/O Port Read/Write | 
Address Status Length _ Description 
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8259 Programmable Interrupt Controller 


Description 


The Intel 8259 Programmable Interrupt Controller handles all interrupts. One 
8259 Programmable Interrupt Controller, or equivalent, is supported by the 
8086 PS/2 BIOS. Compatibility with interrupts expected in existing software is 


maintained in the PS/2—compatible BIOS. 


Levels of interrupts 


There are eight levels of interrupts. Several devices may share the same 
hardware interrupt, which reduces the interrupt controller’s sensitivity to a 
transient signal on the |/O bus. 


Interrupt uses 


The following table shows how interrupts are used in 8086—based PS/2- 
compatible systems: 


interrupt System Board : iiO Channel 
Level Availability Availability Comments 


Timer channel 0 Not available Called by INT 71h 


IRQ 1 Keyboard, pointing de- Not available 
vice, and real time 
clock 


Serial port Available 


O 

O 

>) 

=. 

me 

Cc | 
4) 

Q. 


Fixed disk Available 
IRQ 7 Parallel port Available ! 
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| Parity check and 1/O channel check Only available on system 
coprocessor | board 
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8259 Programmable Interrupt Controller, Continued 


Interrupt Sharing 


Multiple adapters may share an interrupt level. Adapters sharing interrupts 
allow the IRQ line to float high, and each adapter causes an interrupt by 
pulsing the line low. Adapters sharing interrupts must monitor the IRQ line, 
and must not issue interrupts until they are rearmed after an interrupt by 
another adapter. 


| Interrupt sharing provides a way to: 


= link an adapter’s interrupt handler to a chain of interrupt handlers, 
= share interrupt levels among active adapters, and 
# unlink the interrupt handler from the chain when the task is deactivated. 
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Miscellaneous Additional Logic 


NMI mask 


The NMI (nonmaskable interrupt) input to the 8086 is masked off at power- 
on reset. Bit 7 of |/O port address OOAOh is set to one to enable the NMI. A 
power-on reset clears this bit. 


System control port (0061h) 
Port O0061h contains information used for system control. 


The following table shows Port 0061h write operations: 


Sa 
Se 
Si ie 
Se 
a 
a 


Beeper data 
Enable timer 2 gate to beeper 


System board status port (0062h) 
The following table shows Port 0062h read operations: 


Description 


eo etamet creck active 
ster a output status 
deseo 
a a 
a aa 
a es 


Coprocessor installed 
Reserved 
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Glossary 


ABIOS 


Advanced BIOS. The BIOS designed to support multitasking operating sys- 


tems such as OS/2. It comes packaged with a traditional Compatibility BIOS 
(CBIOS). 


Adapter Card 


A circuit board that can be installed into one of the expansion slots inside 


a PS/2-compatible computer in order to expand the capabilities of the 
computer. 


Adapter Description Files (ADFs) 


Text files supplied on a diskette by manufacturers of PS/2-—compatible 
adapter cards. The ADFs contain information such as what resources are 
needed to use the card. The ADFs must be copied to a working copy of the 
Reference Diskette after the adapter card is installed. 


Adapter ROM 


The read-only memory on the adapter, which contains code to control the 
adapter device. An adapter is a peripheral card that extends the operation 
of the system. For example, a fixed disk drive controller is an adapter that 


may have an adapter ROM. Adapter ROM code may include an ABIOS ROM 
extension. 
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Glossary, Continued 


Address Bus 


One or more lines (conductors) that carry address codes from the micropro- 
cessor to all parts of the system. __ 


Arbitration 
Arbitration is a process through which devices compete for possession of 
the channel on a prioritized basis. 

Arbitration Level 
Arbitration levels are the levels of priority assigned to devices that compete 
for possession of the channel. 

Bimodal Operation 
Refers to the ability of a program to operate in both the real address mode 
and the protected address mode of the 80286, 80386SX, or 80386 micropro- 
cessor. ABIOS services are bimodal; they operate in either real or protected 
mode. 

BIOS 
Basic Input/Output System. Systems software that interfaces between the 
operating system and hardware. 

Boot 
Process of starting the computer. 


Burst Mode 


Burst mode is a method of DMA transfer that allows a device to remain in- 
active for long periods and then send large amounts of data in a short time. 


Bus 
One or more lines (conductors) that carry signals or power. 


Byte 
Eight contiguous bits; a bit is the smallest item of information that a com- 
puter can process. 


Cache 
Method of using a fast device to speed up access to a slow device. 
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Glossary, Continued 


CBIOS 
Compatibility BIOS. The traditional single-tasking portion of a PS/2- 
compatible BIOS. 

CBIOS Service 
A software routine that services a given peripheral device, and provides an 
interface between the operating system and the hardware. These services 
are single task, call/return functions, as opposed to the device services 
offered by ABIOS. 

CMOS 
Acronym for Complementary Metal Oxide Semiconductor. In PS/2 compat-— 
ibles, it is low-power memory that is battery-backed and is therefore not 
lost when the computer is turned off. 

Configuration 
The process of setting up all the parts of the computer so they run 
effectively. 

Cyclic Redundancy Check (CRC) 
A method of redundancy check where the check key is produced by a cyclic 
or repeating algorithm. A common means of error checking. 

Default 
A value, setting, or option that is assigned by the program or system. 


Direct Memory Access (DMA) 
Direct Memory Access is a means for I/O devices to transfer data directly to 
and from system memory without the intervention of the microprocessor. 
This significantly decreases |/O processing by the microprocessor. 

DMA Controller 


A DMA controller is a device which gives addresses and control signals to 
the device that has won the bus through arbitration. The controller does not 
enter into the arbitration itself. 


DMA Device 


A DMA device enters into arbitration for the channel. If it wins, it receives 
addresses and control signals from the DMA controller so it can read or 
write data. 
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Glossary, Continued 


DOS 
Acronym for Disk Operating System and short for PC-DOS and MS-DOS. 
DOS, like other operating systems, organizes the files and memory for other 
programs. 


Error Handler 


An invisible program on the Reference Diskette that reads the POST error 
log. If an error is found, a cause and solution type message about the error 
is displayed. 


Expanded Memory 


For AT-compatible systems, up to 32 MB of additional “paged” memory 
above the DOS 640K limit. Application programs written according to LIM 
EMS or AST EEMS specifications can use this type of memory. Examples of 
such programs are Lotus 1-2-3, Symphony and Framework. 


Expanded Memory Specification (EMS) 


For AT-—compatible systems, a specification and protocol established by a 
consortium of computer manufacturers, principally Lotus, Intel, and Microsoft 
(LIM), which establishes a set of rules for organizing and accessing ex- 
panded memory. 


Extended Expanded Memory Specification (EEMS) 


A specification and protocol established by a consortium of computer manu- 
factures, principally AST, Quadram, and Ashton-Tate, which establishes a 
set of rules for organizing and accessing expanded memory. 


Extended Memory 


The memory above 1 MB. XENIX and IBM’s VDISK can use this memory, but 
DOS and almost all application programs cannot, since use of the protected 
mode of the Intel 80386 or 80386 microprocessor is required. 


Fixed Disk (Hard Disk) 


A magnetic storage device consisting of a drive mechanism with perma- 
nently installed metallic disks; a “filing cabinet” for the computer. 


Hardware 
The physical equipment and components in the computer system. 


continued 
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Glossary, Continued 


Interrupt 
The suspending of microprocessor program execution by a demand for at- 
tention coming from a peripheral device. After the interrupt has been serv- 
iced, the suspended microprocessor task can be resumed where it was 
broken off by the interrupt. 

Kilobytes (K) 
1024 bytes. 

Known State 
When a device is initialized or reset, and then set to a particular pre— 
established condition, it is said to be in a known state. 

Low Level Format 
Electronic equivalent of drawing a detailed street map on the fixed disk. The 
electronic markings tell the system at what points to start and end reads 
and writes. 

Main Memory 
The memory between 0 and 1 MB. 

Megabyte (MB) 
One million, or 1024 x 1024 bytes. 

Memory 
A device that can store data recorded in it and from which the data can be 
retrieved. 

Micro Channel 


Information is exchanged between the computer system board and the 
adapter cards which are plugged into it by means of the “bus.” Micro Chan- 
nel refers to the particular bus design in a PS/2-compatible computer. It is 
also referred to as MCA, for Micro Channel Architecture. 


Microprocessor 
Central processing unit, or “brain” of the computer. 
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Glossary, Continued 


Multitasking 
Multitasking programs execute multiple program modules simultaneously. 
Information input into one module does not need to be processed completely 
before information can be input into another module. ABIOS supports multi- 
| ple concurrent requests. 

Offset 
A method of addressing that defines an address as relative to the beginning 
of a memory segmenrt. 

Operating System 
Generic systems software which controls the execution of applications 
software. 

Option Diskette 
The diskette provided by manufacturers of adapter cards that contains 
adapter description files (ADFs), which are written to the Reference Diskette 
and used by it to configure the system. 

Parameter 
Value, option, or setting that can be set in two or more ways. 


Power-on Self Test (POST) 
A program that tests all parts of the computer every time you turn on the 
computer. 

Program 
A set of instructions defining the operations of a computer in order to 
achieve the desired results. 

Programmable Option Select (POS) 


A way of setting up peripheral devices on a PS/2 machine via the power- 
on self test (POST), in which values are placed in registers on the devices. 
This software set up routine replaces the traditional switches and jumpers 
on devices. 


continued 
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Glossary, Continued 


Protected Virtual Address Mode (Protected Mode) 


One of two 80286 or three 80386 memory addressing modes. In protected 
virtual address mode, the 80386/80286 uses all address lines. This allows 
addressing of up to 16 megabytes of physical memory in an 80286 and 4 
GB in an 80386. The 80286 processor’s internal memory management allows 
addressing of an additional 1 gigabyte of virtual memory in protected mode 
(the 80386 up to 64 Terabytes). Protected mode addresses are specified in 
selector:offset format. ABIOS data structures support protected mode ac- 
cess of all ABIOS services. 


PS/2-Compatible Computer 


Any computer that can run software programs written for an IBM PS/2 
computer. IBM PS/2 systems come in two basic varieties: Models 25 and 30 
versus Models 50, 60, 70, and 80. The former systems do not implement 
the Micro Channel Architecture (MCA). 


Real Address Mode 


One of two 80286 memory addressing modes (the 80386 has three). In real 
address mode, the 80286 and 80386 microprocessors use 20 address lines, 
thus allowing memory addressing of up to 1 megabyte of physical memory 
(220), Real address mode does not support virtual memory addressing. Real 
mode addresses are specified in segment:offset format. ABIOS data struc- 
tures support real mode access of all ABIOS services. 


Reference Diskette 
In PS/2-compatible MCA-based systems, POST error recovery, access to 
system utilities, and system configuration are all controlled by a utility disk- 
ette, the Reference Diskette. The Reference Diskette can automatically 
configure a system, resolving conflicts between adapter card settings, and 
optimally configuring the system. 


Segment 


A unit of contiguous, one-dimensional address space. In real mode, these 
address blocks are 64K in size, referenced by one byte. In protected mode, 
programs can allocate segments of any size they require up to 64K. 
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Glossary, Continued 


Selector 
A value contained in a segment register (such as the CS, DS, SS, or ES 
segment registers) when in protected mode. This value determines what 
segment is currently being used; e.g., with CS, what segment is being used 
for executing code. 

- Single-Tasking 
Single-tasking operating systems can only execute one program module or 
routine at a time. Information input into a module or routine must be proc- 
essed completely before information can be input into another module. 

Software 
A comprehensive term used to identify all of the nonhardware components 
of a computer. Software includes computer programs and data. 

System Board 
A large circuit board that holds most of the main electronic parts of the 
computer. 

System Board ROM 
Read-only memory chips that reside on the system board and provide 
control information for various system components. 

Task 
In an 80386, a task is the execution of a single process or set of instruc-— 
tions to perform a particular function. It is not the same as an operating 
system task. 

Time-—Out 
When the interval of time expected for a certain process (an interrupt) to 
occur is exceeded. 

Virtual 8086 Mode (80386 only) 


A way of emulating the 8086 or 8088 microprocessors on the 80386. The 
8086 program runs in protected mode as a task that can run with multiple 
8086 virtual tasks, as well as alongside other multiprogrammed 80386 tasks. 
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Additional Resources 


The following books provide additional material related to the CBIOS: 


Dettman, Terry R. DOS Programmer’s Reference. Carmel, IN: Que® 
Corporation, 1988. 


Duncan, Ray. Advanced MS-DOS Programming. Redmond, WA: Microsoft 
Press, 1986. 


Duncan, Ray. IBM® ROM BIOS. Redmond, WA: Microsoft 
Press, 1988. 


International Business Machines Corporation. /BM® Personal System/2™ 
and Personal Computer BIOS Interface Technical Reference. Boca Raton, 
FL: IBM, 1987. 


International Business Machines Corporation. /BM® Personal System/2™ 
Model 30 Technical Reference. Boca Raton, FL: IBM, 1987. 


International Business Machines Corporation. /BM Personal System/2™ 
Mode/ 50 and 60 Technical Reference. Boca Raton, FL: IBM, 1987. 


Norton, Peter and Wilton, Richard. The New Peter Norton Programmer’s 
Guide to the IBM® PC and PS/2®. Redmond, WA: Microsoft Press, 1988. 


Wadlow, Thomas A. Memory Resident Programming on the IBM PC. 
Reading, MA: Addison-Wesley Publishing Co., Inc., 1987. 


Wilton, Richard. Programmer’s Guide to PC® and PS/2™ Video Systems. 
Redmond, WA: Microsoft Press, 1987. 
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A 


Abbreviations, xili—xiv 


ABIOS, 1-2 
and Diskette Service, 268 
and Fixed Disk Service, 303 
initialization of, 363-364 
for multitasking operating systems, 
25 
and POST, 111 


Acknowledge keyboard reply, 476 
Acknowledge mouse reply, 480 
Acronyms, xili-xiv 

Active character blocks, 216 

Active display code, 238 

Active page, 192, 238 

Adapter description files, 28, 49 
Adapter enable POS subfunction, 397 


Adapters 
asynchronous communication, 78 
enabling of, 397 
error messages for, 445, 455 
IDs for, 358 
in CMOS RAM, 93, 295 
in extended CMOS RAM, 95-97, 
296-297 
POS, 63 
interrupt registers for, 491 
Micro Channel support for, 27 
multiscan monitor cables for, 
31,<505 
printer, 78, 403 
setting of, 104 
slots for, 5, 9, 103 


Address line failures, 442, 454 


Index 


Address modes, microprocessor, 
25, 499 


Addresses, |/O Port 

CMOS RAM register port for, 60, 
89, 122, 257, 291, 357, 410, 
425, 436 

CRT controller, 238 

DMA controller, 42-43, 48, 55-56, 
60-63, 482-484 

extended CMOS RAM port for, 89 

parallel port, 33, 64-65, 68-69, 503 

for PICs, 50 

POS adapter register, 396 

ROM, compatibility of, 100-101 

serial port, 34, 65-67, 71-73, 
331-336 

for system control port, 52, 59-61, 
121-122, 172, 291, 357, 422, 
436, 487 

video expansion ROM, 115 


ADF (adapter description files), 28, 
49 


Alarm 
in CMOS RAM, 411 
interrupt processing for, 423 
real time clock, 90, 417-418, 
489-490 


Allocated bytes, 85 


Alt key, 133 
and character code tables, 153-162 
and pause state table, 139 
status of, 145 
work area for, 79, 135 


Alternate Keyboard layouts, 368 


Alternate Reset Fixed Disk, Fixed Disk 
Service, 318-319 


Alternate scan codes, 474 
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A, cont’d 


Alternate Select, Video Service, 229 
Enable/Disable cursor scaling, 233 
Enable/Disable default palette load- 
ing during set mode, 232 

Enable/Disable summing to gray 
shades, 233 

Enable/Disable video, 233 

Return VGA Information, 230-231 

Select scan lines for text modes, 
232 

Switch Display, 234 

Switch to alternate print screen rou- 
tine, 231 

Video screen ON/OFF, 234 


Analog monitor support, 31, 171, 
177, 505 


Applications programs, compatibility 
for, 3 


Arbitration levels, 61 
and bus sharing, 41 
and DMA controller, 45-46 
for fixed disks, 86, 294 
register for, 122, 436 


Arbus register, DMA, 43, 47 
Arithmetic operations, 26, 500 
ASCIil characters, 151-162 


Asynchronous communication 
adapters, 78 


Attention register, fixed disk adapter, 
68, 292, 492 


Attributes 
address register for, 69, 172, 493 
controller for, 30, 169-170, 247 
and memory maps, 216 
reading of, from screen, 194 
writing of, to screen, 195-196, 202 


Autoinitialization of DMA controller, 43 


Auxiliary character generator 
second text mode, pointer to, 185 
text mode, pointer to, 182 
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Auxiliary devices 
controller for, 32 
data for, 85 
Intel 8042 interface commands for, 
470-471 
status of, 392 


B 


Background color, 198 
Backspace as control character, 201 
Banks, memory, 31, 171 


Base memory 
in CMOS RAM, 93 
message for, 450, 458 


BASIC, interrupts for, 9, 77 
BAT (Battery Assurance Test), 476 
Battery failure, 444 


Baud rate © 
generator for, 35, 331, 502 
initialization of, 110, 338, 340, 
345-346 
ROM compatible address for, 100 


Beep, bell character for, 201 
Beep codes, 440, 442-443, 454 
Bell as control character, 201 


Bimodal operating systems, ABIOS 
for, 2 


BIOS 
data area for, 5, 242 
video state, 242, 248-250 
See also ROM and ROM BIOS 


Blinking attribute, 206 


Blocks 
moving of, 376-377 
specifier for, 216-217 


Blue value, address for, 250 
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B, cont’d 


Booting 
error messages for, 441, 449, 457 
and POST, 117, 449 
service entry point for, 100 


Bootstrap Loader interrupt, 9, 77, 
433-437 


Border control register, CGA, 494 


Break key, Keyboard Service, 
136-137 


Breakpoint interrupt, 8, 76 


Buffers 
fixed disk, 86, 320-321 
keyboard, 79, 81, 116, 135, 147, 
464, 486 
video, 174-175, 238, 243 


Build Initialization Table, System 
Services, 364 


Build System Parameters Table. 
System Services, 363 


Burst mode for DMA transfer, 45 
Bus controller, 501 
Bus sharing, 41 


Busy devices, 381 
printer, 430 


BUSY math coprocessor signal, 
26-27, 500 


Bytes per sector parameter, 105, 264 


C 


Cables for multiscan monitors, 
31, 505 


Cancel set interval wait subfunction, 
372 


Capacity, diskette, 256 


Caps Lock key, 133 
and character code tables, 151 


Index 


and pause state table, 139 
Status of, 145 


Card selected feedback register, 
DMA, 61 


Carriage return as control character, 
201 


CBIOS data area, 78-84 
extended, 85-86 


CDC fixed disks, 108, 299 


Central Arbitration Control, 27 
and DMA bus time-out errors, 125 
and DMA controller, 45 
and NMis, 119 


Century in CMOS RAM, 94, 411 
CGA. See Color Graphics Adapter 


Character generators 
graphics mode, 183 
ROM, 178-179 
second text mode auxiliary, 185 
text mode auxiliary, 182 
Video Service for, 213 
Get font pointer information, 228 
Load 8x8 double dot text mode 
font, 215 
Load 8x16 ROM text mode font, 
217 
Load ROM 8x8 double dot text 
mode font, 221 
Load ROM 8x14 text mode font, 
215, 220 
Load ROM 8x16 text mode font, 
222 
Load user text mode font, 214, 
219 
Set block specifier, 216-217 
Set user graphics font pointer at 
INT 1Fh, 223 
Set user graphics font pointer at 
INT 43h, 224 
Use ROM 8x8 double dot font for 
graphics, 226 
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C, cont’d 
Use ROM 8x14 font for graphics, 
225 
Use ROM 8x16 font for graphics, 
227 | 
Characters 
blocks of, 239, 241 
codes for, 151-162 
control, 197, 201 
and fonts, address for, 100 
height of, 81, 180, 248 
printing of, 404 
reading of, from screen, 194 
receiving of, 343 
sending of, 342 
serial port, 34, 331, 340, 345, 502 
size of, in video modes, 174-175 
writing of, to screen, 195-197 


Checksum and checksum errors, 
442, 454 
optional ROM, 457 
power-on password, 94, 437 
real time clock register for, 491 
and ROM detection, 115 


Clear Byte Pointer, DMA, 55, 63, 
257, 483 


Clear Mask Register, DMA, 56, 63, 
483 


Clearing of screen, 187 


Clock generator, 36, 420, 424, 501, 
507 


Clock Time, 413 

Read System Timer Day Counter, 
418 

Read System Timer Time Counter, 
412 

Real Time Clock ISR, 423-425 

Reset Real Time Clock Alarm, 418 

Set Real Time Clock Alarm, 417 

Set Real Time Clock Date, 416 

Set Real Time Clock Time, 414 

Set System Timer Day Counter, 419 
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Set System Timer Time Counter, 
413 

System RAM for, 410, 421, 424 

System Timer ISR, 420-422 


Closing of devices, 369 


CMOS RAM, 4-6, 40, 87 


diskette drive type in, 276 

for Diskette Service, 263 

failure of, 442-443, 448 

for Fixed Disk Service, 295-297 

initialization and testing of, 113-114 

I/O ports for, 89 

for passwords, 54, 437 

port addresses for, 60, 291, 357 — 

reading from, 39 

registers for, 5, 60, 89, 122, 257, 
291, 357, 410, 425, 436 

for System Services, 361 

for Time-of-Day Service, 410-411, 
425 

writing to, 39 


Collision detection, 200 


Color Graphics Adapter 


compatibility of, 31, 163, 171, 174, 
176, 505 : 

cursor with, 189 

display code for, 236 

initialization of, 170 

registers for, 494 

screen writing by, 196 

video paging in, 192 


Color monitors, testing of, 443 


Colors 


available, 238 

paging mode for, 210, 212 

registers for, 31, 208-209, 211 

in video modes, 174-177 

See also Palettes and palette 
registers 


Columns on screen, 80, 180, 238, 


248 
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C, cont’d 


Command byte 
for diskette controller, 80 
for Intel 8042, 60, 172, 464, 467, 
470 


Command port, device, 488 


Compatibility, 1 
ABIOS for, 2 
CBIOS for, 3 
diskette, 254-255 
keyboard, 143, 148 
of ROM addresses, 100-101 
of video modes, 31, 163, 171, 174, 
176, 505 


Configuration 
for adapter slots, 5 
CMOS RAM data for, 92-94 
data table for, 100 
for disk drives, 29, 504 
diskette controller register for, 71, 
258, 496 
error message for, 455 
POS byte for, 295 


Connectors, Micro Channel extension, 
27-28 


Control 

characters for, 197, 201 

EGA/VGA bits for, 82, 181, 249 

fixed disk, 81, 107, 298, 491-492 

keyboard port for, 487 

parallel port, 33, 65, 68-69, 
401-402, 493, 503 

PIT word register for, 59, 121, 422 

system port for, 515 

system timer register for, 486 

timer byte for, 356 

timer channel registers for, 38 

video bits for, 82, 180, 249 


Controllers 
attribute, 30, 169-170, 247 
CRT. See CRT controller 
diskette. See Diskette controller 
DMA, 41-48, 511-512 
fixed disk, 29, 51, 114, 293, 504 


index 


interrupt, 121, 489, 508 

keyboard. See Intel 8042 keyboard 
controller 

serial port, 34-35, 331, 502 


Conversion logic, bus, 501 
Coordinates, joystick, reading of, 373 


Coprocessors. See Math 
coprocessors 


Copy protection, diskette, 275 


Counts and counters 
of days, 84, 410, 421 
in DMA controller, 42-44 
PIT, 37-38, 59, 356 
real time clock, 489 


tick, 410 
timer, 80, 357, 410, 418-419, 421, 
424, 486 
wait, 84, 359, 424 
CPU 


clock for, 36, 420, 424, 501, 507 
initialization of, 113 
testing of, 113, 442, 454 


CRC (Cyclic Redundancy Check), 273 
in CMOS RAM, 94 
in extended CMOS RAM, 97 
for fixed disks, 309 


CRT controller, 30, 169, 504 
address of, 238 
index register, 68, 70, 172-173, 
493-494 
initialization and testing of, 114 
registers for, 246 


Ctrl key, 133 
and character code tables, 153-162 
and pause state table, 139 
status of, 145 


Ctrl, Alt, and Del keys, 112, 119, 
135-136 


Ctrl-Break flag, 81 
Ctrl and Break keys, 135-137 
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C, cont’d 


Ctrl and Num Lock keys, 136, 
138-139 


Current mode select register, 80, 
180, 248 


Current pages 
address of, 80, 180, 248 
number of, 80, 180, 248 
size of, 80, 180, 248 


Current palette value, 80, 180, 248 
Current track number, 83, 262 
Current video state, 244 


Cursor _ 
in graphics modes, 176 
positioning of, 80, 180, 190-191, 
238, 248 
scaling of, 233 
type of, 80, 180, 188-189, 248 


Cyclic Redundancy Check, 273 
in CMOS RAM, 94 
in extended CMOS RAM, 97 
for fixed disks, 309 


Cylinders, 107-109, 298 
current number, 365 
formatting of, 310 
seeking of, 317 


D 


DAC. See Digital-to—analog 
converters 


Data 
auxiliary device port for, 85 
BIOS area for, 5 
CBIOS area for, 78-84 
CMOS RAM area for, 5, 60, 89, 
122, 257, 291, 357, 425, 436 
device port for, 488 


diskette controller register for, 70, 


258, 496 
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diskette transfer rates, 82, 256, 
261, 280 

DMA transfer of. See Direct 
memory access 

extended BIOS area for, 5, 385, 
421, 432 

extended CMOS RAM area for, 5, 
40, 60, 89, 95-98, 291, 294, 
410 


keyboard/auxiliary port for, 59, 357, 


436 
length of, diskette, 106, 265 
parallel port for, 33, 68-69, 
401-402, 491-493, 503 
video register for, 69, 172, 494 


Date 
in CMOS RAM, 411 
error message for, 445 
in real time clock, 90, 415-416, 
490 | 
ROM compatible address for, 101 


Day of week 
in CMOS RAM, 411 
in real time clock, 90, 490 


Days, count of, 84, 410, 421 


Decreasing available memory mes- 
sage, 450, 458 


Default settings 
for cursor, 189 
for fonts, 179 
for keyboard, 474-475 
for mouse, 479 
for palette, 232 
for video modes, 177 


Defect map, fixed disk, 108-109, 
299-300 


Delay 
diskette motor drive, 105, 264 
typematic, 146, 474 


Detect Media Change, Diskette 
Service, 279 


Device Busy, System Services, 381 
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Device Close, System Services, 369 


Device driver far call initialization sub- 
function, 393-394 


Device drivers, offset for, 85, 360 
Device Open, System Services, 369 


Devices 
closing of, 369 
command port for, 488 
mouse type, 479 
opening of, 369 
pointing type, 390 
service routines for, 7, 10-12 
size of, in DMA controller, 44 


Diagnostic status in CMOS RAM, 92, 
263, 295, 437 


Diagnostics, fixed disk, long sectors 
for, 314-315 


Diagnostics 1: Read Test Buffer. 
Fixed Disk Service, 320 


Diagnostics 2: Write Test Buffer, 
Fixed Disk Service, 321 


Digital input register, diskette con- 
troller, 71, 258, 496 


Digital output register, diskette con- 
troller, 70, 258, 422, 495 


Digital-to—analog converters, 30-31, 
168-170, 505 
color registers for, 211 
port addresses for, 69, 172, 493 
state of, 242, 250 


Direct memory access 

arbitration levels for, 46 

controller for, 41-48, 511-512 

and Micro Channel, 27 

port addresses for, 48, 55-56, 
60-63, 482-484 

time-out errors and messages for, 
125-126, 451-452 


Direct memory Access (DMA) Bus 
Time-out message, 452 


Index 


Disable watchdog time-out subfunc- 
tion, 395 


DISKCOPY command (DOS), 271 


Diskette BIOS Revector interrupt, 9, 
77 


Diskette controller 
command bytes for, 80, 260 
information for, 83, 261 
initialization and testing of, 114 
parameter table for, 100 
port addresses for, 70-71, 
257-258, 495-496 


Diskette Hardware Interrupt service, 
282-283 


Diskettes and disk hardware, 29 
and ABIOS, 268 
CMOS RAM data for, 263 
Current track number, 83, 262 
data rate information for, 82, 255, 
261 
drive type of, 92, 254, 263, 278, 
280, 
entry point for, 100 
error handling for, 266-267 
error messages for, 445, 447, 455 
hardware environment for, 254-256 
I/O ports for, 257-258 
initialization and testing of, 114 
IRQ assignment for, 51 
media type, 83, 254, 261, 281 
motor count for, 420 
motor status of, 79, 259, 421 
parameters table for, 9, 77, 
105-106, 264-265, 276-277 
recalibration status of, 79, 259, 283 
resetting of, 304 
ROM BIOS data for, 264-265 
services for, 8, 17, 76, 251-253 
Detect Media Change, 279 
Diskette Hardware Interrupt, 
282-283 
Format Diskette Track, 274-275 
Read Diskette Sectors, 271 
Read Diskette Status, 270 
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Read Drive Parameters, 276-277 
Read Drive Type, 278 
Reset Diskette System, 269 
Set Diskette Type, 280 
Set Media Type for Format, 281 
System RAM data for, 259-262 
Verify Diskette Sectors, 273 
Write Diskette Sectors, 272 
status return code for, 80, 260 
transfer rate of, 82 
work area for, 83, 262 


Display. See Screen; Video 


Display combination code 
index to, 181, 249 
pointer to, 184 
read/writing of, 236-237 


Divide by Zero interrupt, 8, 76 


Divisor latch, serial port, 65, 71, 332, 
334, 496 


DMA. See Direct memory access 
Door, diskette, 279 


DOS 
interrupts for, 6, 9, 77 
system messages for, 202 


Dot fonts, 178 


Double dot fonts 
graphics mode, 226 
text mode, 215, 221 


Drive ready, testing for, 322 
DSR (device service routines), 10-12 
Dummy interrupt handler, 101 


Dynamic save area, 182 


E 


ECC (Error Correction Code), 315 
Echo, keyboard, 474, 476 
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EGA. See Enhanced Graphics Adapter 
EGA/VGA control bits, 82, 181, 249 
EGA/VGA switch data, 82, 181, 249 


84-key keyboard filtering, 143-144, 
148, 153-157, 368 


Emulation of video modes, 174-176 


Enable channel for setup POS sub- 
function, 396 


Enable/Disable cursor scaling video 
subfunction, 233 


Enable/Disable default palette loading 
during set mode video subfunc- 
tion, 232 


Enable/Disable pointing device sub- 
function, 388 


Enable/Disable summing to gray 
shades video subfunction, 233 


Enable/Disable video subfunction, 233 
Enable register, real time clock, 489 


Enable watchdog time-out subfunc- 
tion, 395 


End-of-interrupt process, 116 
End of track, diskette, 106, 264 


Enhanced Graphics Adapter 

compatibility with, 31, 163, 171, 
174, 176, 505 

cursor with, 189 
display code for, 236 
initialization of, 170 
screen writing in, 196 
video paging in, 192 


Enter password message, 435, 453 


Environment. See Hardware 
environment 


EOI (end-—of-interrupt) process, 116 
Equipment installed in CMOS RAM, 93 
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Equipment List service, 16, 431 
entry point for, 100 
interrupt for, 8, 76 


Error Correction Code, 315 


Error handling 
for Diskette Service, 266-267 
for Fixed Disk Service, 82, 301-303 
for math coprocessors, 27 
for parallel printer services, 404 
by POST, 113, 118, 440-441 
for Serial Communications Service, 
339 
for Time-of-Day Service, 412 
See a/so Parity errors 


Error log 
numbers for, in extended CMOS 
RAM, 97-98 
POST, 85, 360, 366-367, 440 


Error messages, 439-441 
beep codes, 442-443, 454 
boot failure, 441, 449, 457 
information, 450 
Model 25 and 30, 454-459 
password, 453 
run time, 451-452 
system failure, 444-448 


ESDI drives 
formatting of, 326-327, 365 
ROM for, 288 


Event wait interval, 371-372 


Expansion memory 
in CMOS RAM, 93, 361 
message for, 450, 458 
size of, 94 


Extended BIOS data area, 5, 85-86, 
385, 421, 432 


Extended CMOS RAM 
data area for, 5, 40, 60, 89, 
95-98, 291, 294, 410 
as feature, 103 
port addresses for, 60, 89, 291 


Index 


Extended commands pointing device 
subfunction, 391 


Extended function execute register, 
DMA, 56, 289 


Extended function register, DMA, 56, 
121, 289 


Extended Initialize serial communica- 
tions service, 345-346 


Extended keyboard, 148-150 


Extended memory 
message for, 450, 458 
size of, 97, 378 


Extended mode 
DMA, 48 
parallel port, 33 
register for, 495 


Extended Serial Port Control service, 
347-350 


Extended System RAM for System 
Services, 360 


Extension connectors, Micro Channel, 
27 


Extension registers, interrupt con- 
troller, 489 


Extra memory, message for, 450, 
458 


F 


FDISK command (DOS), 326 


Feature control, VGA, 68-70, 
103-104, 172-173, 493-494 


Feature information byte in System 
Configuration Table, 102, 362, 
384 


FIFO control register, serial port, 66, 
72, 333, 335 


Filler byte, diskette, 106, 265 


Filtering of Keyboard, 143-144, 148, 
153-157, 368 
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Firmware, Intel 8042, 466-468 


Fixed disk 
and ABIOS, 303 
arbitration levels for, 86, 294 
buffer for, 86 
CMOS RAM for, 295-297 
control byte, 81 
controllers for, 29, 51, 114, 293, 
504 
and Diskette Service, 252 
drive type for, 92, 295, 324 
entry point for, 100 
error handling of, 301-303 
error message for, 455 
error register for, 82 
failure of, 447-448 
hardware environment for, 288 
interrupt for, 8-9, 76-77 
interrupt flag for, 82, 293 
I/O ports for, 289-292 
number of, 81, 260, 293, 437 
parameters table for, 9, 77, 86, 
97, 100, 107-109, 294, 297, 
311-313 
port registers for, 64, 67-68, 81, 
292, 298, 491-492 
ROM BIOS for, 298-300 
services for, 18, 285-287 
Alternate Reset Fixed Disk, 
318-319 
Diagnostics 1: Read Test Buffer, 
320 — 
Diagnostics 2: Write Test Buffer, 
321 
Format Disk Cylinders, 310 
Format ESDI Drive, 326-327 
Initialize Drive Parameters, 313 
Park Heads, 325 | 
Read Disk Sectors, 306-307 
Read Disk Status, 305 
Read Disk Type, 324 
Read Drive Parameters, 311-312 
Read Long Disk Sectors, 314-315 
Recalibrate Drive, 323 
Reset Diskette(s) and Fixed Disk, 
304 
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Seek to Cylinder, 317 

Test for Drive Ready, 322 

Verify Disk Sectors, 309 

Write Disk Sectors, 308 

Write Long Disk Sectors, 315-316 
Status register for, 82 
System RAM for, 293-294 


Fixed Disk Read Failure message, 449 
Flag register and interrupts, 6, 10 


Flags 
Ctril-Break, 81 
in DMA controller, 42-43 
extended keyboard status, 150 
fixed disk interrupt, 82, 293 
keyboard shift, 79 
in keyboard status register, 464 
pointing device, 85, 360 
shift, 134-135, 145 
system control, 53 
System Reset, 81, 437 
24 hour roll over, 80, 410, 421, 

424 

user wait, 84, 359, 424 
wait active, 84, 262, 359, 424 


Flashing displays, 198 
Floating point operations, 26, 500 


Fonts 
default, 179 
double dot 
graphics mode, 226 
text mode, 215, 221 
pointers for, 223-224, 228 
ROM, 178 
graphics mode, 225, 227 
text mode, 215, 217, 220-222 
sequencer for, 30, 169 
size of, 218 
user 
graphics, 223-224 
text mode, 214, 219 


FORMAT command (DOS), 326 
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Format Disk Cylinders, Fixed Disk 
Service, 310 


Format Diskette Track, Diskette 
Service, 274-275 


Format ESDI Drive, Fixed Disk 
Service, 326-327 


Format ESDI Drive Periodic Interrupt, 
System Services, 365 


Format of first byte of diskette, 105, 
264 


Format/4 command (DOS), 255 
Function descriptions, 11-12 


Function register in DMA controller, 
43 


Functionality/State Table, 237-241 


G 


Game control adapter, 373-374 
Game port address, 64 
Gap length, diskette, 106, 265 


Gate array 
I/O support, 502-506 
system support, 501 


General expansion ROM, 115 


Get font pointer information video 
subfunction, 228 


Get Time function (DOS), 371, 375 


Global Descriptor Table, 376-377, 
379-380 


GRAFTABL command (DOS), 223 


Graphics controller, VGA, 30, 169, 
247 


Graphics modes, 174-176 
character generator for, 183 
fonts for, 223-227 
VGA registers for, 69, 173, 494 


Index 


writing to screen in, 196 


Gray scale summing, 233 
Gray shades, 212 
Green value, address for, 250 


H 


Hardware environment, 23-24, 481 
clock generator, 36 

CMOS RAM, 40 

for Diskette Service, 29, 254-256 
DMA controller, 41-48, 511-512 


for Fixed Disk Service, 288 

independence from, 1, 3 

Intel 8259 Programmable Interrupt 
Controller, 513-514 

interrupt controller extensions, 508 

interrupts for, 7-9, 282-283 

I/O port list, 55-73, 482-498 

I/O support gate array, 502-506 

for Keyboard Service, 32, 131 

math coprocessors, 26-27, 500 

Micro Channel, 27-28 

microprocessors, 25, 499 

NMI mask, 54, 515 

parallel port, 33 

for Parallel Printer Service, 401-402 

parameter tables for, 7 

POST tests for, 113-114 

power-on passwords, 54 

Programmable Interrupt Controller, 
50-51 

Programmable Interval Timer, 37-38 

Programmable Option Select, 49 

real time clock, 39 

for Serial Communications Service, 
34-35, 331 

system board status port, 515 

system control ports, 52-53, 515 

for System Services, 356 _ 

system support gate array, 501 

for system timers, 36-39, 507, 
509-510 
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for Time-of-Day Service, 410, 421, 
424 | 

for Video Service, 30-31, 168-171 

video state of, 242, 245-247 


Hardware Retriggerable system timer 
modes, 37, 510 


Heads 
diskette, 275 
fixed disk, 107-109, 298, 325 
seek delay time of, 106, 265 


Height, character, 81, 180, 248 
High density diskettes, 255 


Hours 
in CMOS RAM, 411 
in real time clock, 90, 490 


IBM fixed disks, 108-109, 299-300 


Identification 
of adapter cards, 49 
of fixed disks, 288 


Inactive display code, 238 


Index register, CRT controller, 68, 70, 


172-173, 493-494 
Information messages, 450 


Inhibit switch in keyboard status reg- 
ister, 464 
Initialization 
of baud rate, 110, 338 
and building of Systems Parameter 
table, 363 
of DMA controller, 43 
error messages for, 455 
failures during, 440, 442 
of interrupt vectors, 7 
of pointing devices, 391, 393-394 
during POST, 113-114 
of video adapters, 170 
of windows, 193 
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Initialization Command Words, DMA, 
57, 289-290, 484-485 


Initialization Table, building of, 364 


Initialize Drive Parameters Fixed Disk 
Service, 313 


Initialize Printer service, 405 


Initialize Serial Communications Port 
service, 340-341 


INMOS G171 DAC converter, 30-31 


Input 
extended keyboard, 148 
Intel 8042 commands for, 471-472 
keyboard, 143, 464-465 
VGA status registers for, 68-709, 
172-173, 231, 493 


Insert key 
and pause state table, 139 
status of, 145 


Installed memory parameter in 
system RAM, 78 


Intel 8042 keyboard controller, 32, 
131, 356, 461-463 

commands and status registers for, 
60, 172, 464, 467, 470 

initialization and testing of, 113 

interfacing by, 468-469 

port addresses for, 60, 172, 357, 
436, 465 

status register for, 464 

system commands for, 470-472 

See also Keyboard 


Intel 8086 microprocessor, 499 


Intel 8087/80287/80387 math 
coprocessors, 26-27, 500 
exceptions for, 9, 77, 127 


Intel 8237 DMA Controller, 41, 113, 
356 


Intel 8253 Programmable Timer chip, 
509-510 
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Intel 8254A Programmable Interval 
Timer, 37-38, 113, 507 


Intel 8259A Programmable Interrupt 
Controller, 50-51, 113, 356, 422, 
513 


Intel 80286/80386/80386SX micropro- 
cessors, 25 


Intel 82284 Clock Generator, 36, 420, 
424, 507 


Intel 82385 Cache Controller, 113 
Intensity/blink bit, setting of, 206 
Intercept, Keyboard, 368 


Internal function requests for Key- 
board Service, 136 


Interrupt Complete, System Services, 
382 


Interrupt on Terminal Count, system 
timer mode, 37, 510 


Interrupt request/In-service registers, 
PIC, 56. 289, 484 


Interrupts and interrupt vectors, 5-9 
controller for, 121, 489, 508 
enable register for, 65, 71, 334, 

497 
fixed disk adapter status register 
for, 68, 492 
fixed disk flag for, 82, 293 
identification register for, 65, 71, 


332, 335, 497 
level-sensitive, 27, 34, 50, 331, 
513 


loading of, 443, 454 

maskable, 50 

PIC mask registers for, 57-58, 290, 
485 

request line for, 7 

ROM compatible address for, 101 

sharing of, 514 

software, 7-12 

table of, 5-9 

See also Nonmaskable interrupts 


Index 


Invalid configuration messages, 445 
Invalid Op Code interrupt, 8, 76 


Invalid Task Segment State interrupt, 
8, 76 


I/O Card Parity Error message, 123, 
451, 459 


I/O Channel Check Activated mes- 
sage, 124, 452 


I/O devices, 29-35, 502-506 
See also specific devices 
I/O expansion ROM, 115 


I/O ports, 55-73, 482-498 

for bootstrap loader service, 
436-437 

for CMOS RAN, 89 

for Diskette Service, 257-258 

for Fixed Disk Service, 289-292 

for Keyboard Service, 134, 465 

for nonmaskable interrupts, 
121-122 

for Serial Communications Service, 
332-336 

for System Services, 356-358 

for Time-of-Day Service, 422, 425 

for Video Service, 172-173 


Isolation, hardware, 1, 3 


ISR (Interrupt Service Routines), 24 


J 


Joysticks, 356 
device support for, 32 
port for, 358 
System Services for, 373-374 


K 


Keyboard, 32, 356, 506 
alternate, layout for, 368 
Break, 137 
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K, cont’d 
buffers for, 79, 81, 116, 135, 147, 
464, 486 
and character codes, 153-162 
data port for, 59, 357, 436 
error messages for, 456 
extended, 148-150 
entry point for, 100 
failure of, 446-447 
hardware environment for, 131 
ID for, 474 
initialization and testing of, 114 
I/O ports for, 134 
interface command for, 471 
interrupt controller extensions for, 
508 
interrupts for, 8, 51, 76 
internal function requests, 136 
keyboard-to-system Ccommunica- 
tion, 132-133 
Pause, 138-139 
Print Screen, 140 
and reading of character code 
tables, 151-152 
scan codes and character code 
tables for, 151 
security for, 435, 453 
services for, 21, 129-130 
Read Extended Keyboard Input, 
148 
Read Keyboard Input, 143 
Return Extended Keyboard Status, 
149 
Return Extended Shift Flags 
Status, 150 
Return Keyboard Status, 144-145 
Return Shift Flag Status, 145 
Set Typematic Rate and Delay, 
146 
shift flags for, 79, 134-135, 145, 
150 
status register for, 135, 144-145, 
464 
Store Key Data, 147 
System RAM data for, 134-135 
System Request, 141 
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System Reset, 136 

system communication with, 
132-133, 474-476 

system replies from, 476 

See also Intel 8042 keyboard 
controller 


Keyboard Break interrupt, 9, 77 
Keyboard controller test failure, 443, 


454 
Keyboard Intercept System Services, 
368 
L 
Landing zones, fixed disk, 107-109, 
298, 325 | 


Last unexpected interrupt, 80 

LED toggle status indicators, 474 
Level-sensitive interrupts, 27, 50, 513 
Light pen position, 191 

LIM EMS Driver interrupt, 9, 77 


Line control register, 66, 72, 333, 
335, 497 


Line feed as control character, 201 


Line status register, 67, 73, 334, 
336, 341, 344-346, 498 


Load 8x8 double dot text mode font 
subfunction, 215 


Load 8x16 ROM text mode font sub- 
function, 217 


Load ROM 8x8 double dot text mode 
font subfunction, 221 


Load ROM 8x14 text mode font sub- 
function, 215, 220 


Load ROM 8x16 text mode font sub- 
function, 222 


Load ROM BASIC interrupt, 8, 76 


Load user text mode font video sub- 
function, 214, 219 
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Loader, bootstrap, 433-437 
Loading of fonts, 179 
Logarithmic operations, 26, 500 
Logical interrupts, 7-8 
Long disk sectors, 314-316 


Low level fixed disk formatting, 
326-327 


M 


Main status register, diskette, 496 
Make codes, 153-162 


Manufacturers of fixed disks, 18, 
299-300 


Manufacturing checkpoint ports, 73 
Manufacturing port register, 489 


Mask register, DMA, 43, 55, 62, 257, 
483 
failures in, 443, 454 


Maskable hardware interrupts, PIC 
for, 50 


Masks 
interrupt controller, 358 
NMI, 54, 515 
PIC, 62, 410, 485 
video DAC PEL, 69, 172, 493 


Master Clear, DMA, 55, 63, 483 
Master DMA register failure, 443, 454 
Master PIC, 425 


Math Coprocessor Not Present inter- 
rupt, 8, 76 


Math coprocessors, 26-27, 500 
exceptions generated by, 127 
IRQ assignment for, 51 
port address for, 63 


MCGA. See Multicolor Graphics Array 


Index 


MDA. See Monochrome Display 
Adapter 


Media 
detection of change in, 279 
types of, diskette, 83, 254, 261, 
281 


Memory 

address register for, 55, 62, 25/7, 
482 

commands for, 470 
controller for, 501 
error messages for, 456-457, 459 
extended, 97, 378, 450, 458 
failures in, 442-443, 445-446, 454 
installed, 78 
messages for, 450-452 
moving blocks of, 376-377 
registers of, as feature, 103-104 
video, 30-31, 171, 239, 505 
See also CMOS RAM; System RAM 


Memory map 2 for fonts, 178 


Memory maps and attribute bytes, 
216 


Memory Parity Error message, 123, 
451 


Memory Refresh arbitration level, 46 


Memory Size service, 17, 432 
entry point for, 100 
interrupt for, 8, 76 


Memory tests terminated by key- 
stroke message, 450, 458 


Messages 
password, 435 
system, 202 
See a/so Error messages 


Micro Channel, 27-28, 97 


Microprocessors, 25, 499 
arbitration level for, 46 
and DMA, 44, 511 
Intel 8042 interfacing to, 468-469 


Miniscribe fixed disks, 108, 299 


541 
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Minutes 


in CMOS RAM, 411 
in real time clock, 90, 490 


Miscellaneous information in CMOS 
RAM, 94 


Miscellaneous output register, VGA, 
69, 172-173, 493-494 


Model 25 and 30 
beep codes for, 454 
error messages for, 455-459 
video modes for, 175 


Model byte in System Configuration 
Table, 102, 362, 383-384 


Models, features of, 103-104 


Modem control register, 66, 72, 333, 
335, 497 
reading and writing of, 348-350 


Modem status register, 67, 73, 334, 
336, 341, 344-346, 498 


Modems, conversion of data from, 35 


Modes 
CGA control register for, 494 
DMA register for, 43, 55, 63, 257, 
483 
select register for, 80, 180, 248 
system timer, 37-38, 510 
video, 174-176, 238-241 


Monitors 
support for, 31, 171, 177, 505 
testing of, 443 


Monochrome Display Adapter 
compatibility with, 31, 163, 171, 
174, 176 | 
cursor with, 189 
display code for, 236 
initialization of, 170 


Monochrome monitors, testing of, 
443 


Month 
in CMOS RAM, 411 
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in real time clock, 90, 490 


Motor, diskette 
count for, 420 
start time, 106, 265 
status of, 79, 259, 421 
turn-off delay, 105, 264 


Motorola MC146818A Real Time 
Clock, 39, 90, 408, 421, 423-424 
CMOS RAM for, 40 


Mouse, 356 
device support for, 32 
IRQ assignment for, 51 
system commands to, 477-479 
system replies from, 480 


Move Block System Services, 
376-377 


Multicolor Graphics Array 
cursor with, 189 
display code for, 236 
modes for, 174-175 
support for, 504 


Multiscan monitor support, 31, 505 


Multitasking operating systems 
ABIOS for, 2, 25 
services for, 369-370, 374, 
381-382 
support for, 282 


N 


National Semiconductor 16550 serial 
port controller, 34-35, 331, 502 


NEC 765 diskette controller, 29, 254, 
503 


New password has been installed 
message, 435, 453 


NMI. See Nonmaskable interrupts 


No Boot Device Available message, 
117, 434, 449 
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No Boot Sector on Fixed Disk mes- 
sage, 449 


No Error Detected Intel 8042 reply, 
473 


No Password Installed Intel 8042 
reply, 473 


Nonmaskable interrupts, 8, 76, 
119-120 
arbitration level for, 46 
coprocessor exceptions, 127 
entry point for, 100 
error message for, 451-452 
I/O ports for, 121-122 
masks for, 54, 515 
parity error handling by, 123-124 
time-out error handling by, 
125-126 


Not a Boot Diskette message, 449 


Num Lock key, 133, 136, 138-139 
and character code tables, 151 
and pause state table, 139 
status of, 145 


Number 
cylinder, 365 
of fixed disks, 81, 260, 293, 437 
of installed devices, 78, 403 
for interrupts, 6-9 
page, 80, 180, 192, 248 
track, 83, 262 


Numeric exception error handling, 27 


Numeric keypad input, work area for, 
7 


O 


101-key keyboard, 143-144, 149, 
152 


Offset, device driver, 85, 360 
Opening of devices, 369 


Operating System Bootstrap Loader 
function, 112 


Index 


Optional ROM checksum errors, 444, 
457 


Out of paper condition, 430 

Output buffer, keyboard, 464, 486 
Output port, Keyboard, 465, 472 
Overflow interrupt, 8, 76 

Overrun characters, keyboard, 476 


Overscan register, 205-207 


p 


Page table address registers, DMA, 
60 


Pages, video, 174-175 
active, setting of, 192 
addresses of, 80, 180, 248 
modes for, 210, 212 
number of, 80, 180, 192, 248 
register for, 257, 442, 454, 488, 
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scrolling of, 193 
size of, 80, 180, 248 


Palettes and palette registers 
default, enabling/disabling of, 232 
reading of, 207 
setting of, 198, 205-206 
user profile table for, 186 
value in, 80, 180, 248 


Parallel ports, 491-493 
addresses for, 33, 64-65, 68-69, 
401-402, 493, 503 
failure of, 447 
hardware for, 33, 503 
IRQ assignment for, 51 


Parallel Printer Service, 22, 399-400 
error handling for, 404 
hardware environment for, 401-402 
Initialize Printer, 405 
interrupts for, 8, 76 


543 


P, cont’d 
services for, 404-406 
Print Character, 404 
Read Printer Status, 406 
System RAM data for, 403 


Parallel—-to—serial conversions, 35 


Parameter passing for functions, 
10-11 2 


Parameters and parameter tables, 7 

diskette, 9, 77, 105-106, 264-265, 
276-277 

fixed disk, 9, 77, 86, 97, 100, 
107-109, 294, 297, 311-313 

system, building of, 363 

system configuration, 383-384 

video, 182, 249 


Parity errors, 442, 454 
in keyboard status register, 464 
messages for, 451, 456, 459 
NMI handling of, 123-124 


Parity modes, serial port, 34, 331, 
340, 345, 502 


Park Heads Fixed Disk Service, 325 


Password has been removed mes- 
sage, 435, 453 


Password Installed Intel 8042 reply, 
473 


Password is incorrect message, 435, 
453 


Password Ok message, 435, 453 


Passwords 
and CMOS RAM, 93 
disabling of, 103-104 
Intel 8042 commands for, 470 
messages for, 435, 453, 473 
power-on, 54, 94, 434-435, 437 


Pause Keyboard Service, 136, 
138-139 


PEL addresses, DAC, 69, 172, 
493-494 


944 


Periodic interrupt processing, 365, 
423 


PGA (Professional Graphics Adapter), 
display code for, 236 


Physical DMA channels, 47 


PIC. See Programmable Interrupt 
Controller 


PIO (programmed I/O), 43 

PIT. See Programmable Interval Timer 
Pixels, 199-200, 250 

Planar control registers, 487-488 


Pointers 

to DCC table, 184 | 

to dynamic save area, 182 

for fonts, 223-224, 228 

to graphics mode character gener- 
ator, 183 

to second text mode auxiliary char- 
acter generator, 185 

state of, 239 | 

to text mode auxiliary character 
generator, 182 

to user palette profile table, 186 

to video parameter table, 182 

to Video Service pointer table #2, 
183 


Pointing device interface initialization 
subfunction, 391 


Pointing Device Interface, System 
Services, 386-394 


Pointing devices 
failures in, 448 
flag for, 85, 360 
initialization and testing of, 114 
interface for, 32, 506 
interrupt controller extensions for, 
508 
interrupts for, 9, 77 
services for, 386-387 
Device driver far call initialization, 
393-394 
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Enable/Disable pointing device, 
388 

Extended commands, 391 

Pointing device interface initializa- 
tion, 391 

Read device type, 390 

Reset pointing device, 388 

Return status, 392 

Set resolution, 390 

Set sample rate, 389 

Set scaling factor to 1:1, 393 

Set scaling factor to 2:1, 393 


Pop up utilities, function for, 203 
Port offset, fixed disk, 81 


Ports. See I/O ports; Parallel ports; 
Serial ports 


POS. See Programmable Option 
Select 


Position select register, 61 


Positioning 
of cursor, 80, 180, 190-191, 238, 
248 
of fixed disk head, 317 
of 1/O expansion RAM, 115 
of light pen, 191 


POST. See Power-on self tests 


Power-on passwords, 54, 94, 
434-435, 437 


Power-On Self Test Error Log System 
Services, 366-367 


Power-on self tests, 111-114, 
366-367 
beep codes by, 442-443 
boot failure messages by, 449 
and bootstrap loader, 433 
and CRC in extended CMOS RAM, 
97 
for EBDA, 385 
entry point for, 100 
error codes, number of, 85, 360 
error handling by, 118, 440-441 


Index 


error log by, 85, 360, 366-367 

information messages by, 450 

and 1/O expansion, 115 

and memory size, 432 

and passwords, 54 

for POS registers, 28, 49 

and real-mode re-entry, 116 

and Serial Port Table, 337 

and system boot, 117 

and system equipment list, 431 

System RAM for, 84 

for vector initialization, 7 

Video Service tables initialization 
during, 181 


Power-on video default modes, 177 


Power-up entry points, ROM com- 
patible, 101 


Primary Video Service table, 181-182 


Print Character, Parallel Printer 
Service, 404 


Print Screen and Print Screen, Key- 
board Service, 13, 136, 140, 
429-430 

alternate routine for, 231 
entry point for, 101 
interrupt for, 8, 76 
status byte for, 84, 429 


Printer 
adapters for, 78, 403 
busy, 430 
entry point of services for, 100 
time-out table for, 81 


Priorities and bus sharing, 41 


Processor 
interrupts for, 7 
switching of, to protected mode, 
379-380 | 


Professional Graphics Adapter, dis- 
play code for, 236 


Program counter and interrupts, 6, 10 


Program Termination, System 
Services, 370 
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Programmable baud rate generator, 
35, 331, 502 


Programmable Interrupt Controller, 
50-51, 356 
master and slave, 425 
port addresses for, 56-58, 61-62, 
291, 484-486 


Programmable Interval Timer, 507 
counter for, 37-38, 59, 356 
failure of, 442 
port addresses for, 58-59 


Programmable Option Select, 49 
configuration bytes for, 93-94, 295 
in extended CMOS RAM, 95-97 
and Micro Channel, 27-28 
port addresses for, 61, 64 
registers for, 122 


Programmable Option Select, System 
Services, 396-397 
Programmed 1/O, 43 
Protected address mode, 25 
error message for, 457 


for math coprocessor, 26 
switching to, 379-380 


PS/2 systems, 3 
features in, 103 
parity error handling in, 124 
time-out error handling in, 126 


Pulse output port, keyboard, Intel 
8042 command for, 472 


R 


RAM. See CMOS RAM; Memory; 
System RAM 


Rate Generator, system timer mode, 
37, 510 


Raw keyboard data stream, filtering 
of, 368 | 


546 


Read all palette registers and over- 
~ scan video subfunction, 207 


Read block of color registers video 
subfunction, 211 


Read Character/Attribute from 
Screen, Video Service, 194 


Read color paging status video sub- 
function, 212 


Read Current Cursor Position, Video 
Service, 191 


Read current switch settings joystick 


subfunction, 373 
Read data command for mouse, 478 
Read device type subfunction, 390 


Read Disk Sectors, Fixed Disk 
service, 306-307 


Read Disk Status, Fixed Disk Service, 
305 


Read Disk Type, Fixed Disk Service, 
324 


Read Diskette Sectors, Diskette 
Service, 271 


Read Diskette Status, Diskette 
Service, 270 


Read Drive Parameters, Diskette 
Service, 2/6-277 


Read Drive Parameters, Fixed Disk 
Service, 311-312 


Read Drive Type, Diskette Service, 
278 


Read Extended Keyboard Input, Key- 
board Service, 148 


Read Extended Memory Size, System 
Services, 378 


Read individual palette register video 
subfunction, 207 


Read Keyboard Input, Keyboard 
Service, 143 
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Read Light Pen Position, Video 
Service, 191 


Read Long Disk Sectors, Fixed Disk 
Service, 314-315 


Read operation for System Control 
Port, 52 


Read overscan register video sub- 
function, 207 


Read Pixel, Video Service, 200 
Read POST error log subfunction, 366 


Read Printer Status, Parallel Printer 
Service, 406 


Read Real Time Clock Alarm and Sta- 
tus, Time-of-Day Service, 418 


Read Real Time Clock Date, Time—of- 
Day Service, 415 


Read Real Time Clock Time, Time-—- 
of-Day Service, 413 


Read resistive inputs joystick subfunc- 
tion, 374 


Read Serial Port Status, Serial Com- 
munications Service, 344 


Read single DAC color register video 
subfunction, 211 


Read System Timer Day Counter, 
Time-of-—Day Service, 418 


Read System Timer Time Counter, 
Time-of—Day Service, 412 


Read the modem control register 
subfunction, 348 


Read/write counter, PIT, 59 


Read/Write Display Combination 
Code, Video Service, 236-237 


Reading 
of attributes, 194 
of character code tables, 151-152 
from CMOS RAM, 39 
of extended keyboard input, 148 


index 


READY input, CPU, 36 


Real address mode, 25 
for math coprocessor, 26, 500 
re-entry of, 116 


Real time clock, 39, 408, 421, 
423-424 

alarm in, 90, 417-418, 489-490 

battery failure for, 444 

CMOS RAM for, 5 

data definitions for, 90 

date in, 415-416 

generator for, 36, 420, 424, 501, 
507 

interrupt controller extensions for, 
508 

interrupt for, 9, 51, 77 

I/O ports for, 489-490 

reading and writing of, 423-425 

time in, 413-414 


Rebooting and NMI clearing, 119 


Recalibrate Drive, Fixed Disk Service, 
323 


Recalibration status, diskette drive, 
79, 259, 283 


Receive Character, Serial Communi- 
cations Service, 343 


Receiver buffer register, 65, 71, 332, 
334, 496 


Recursive print screen requests, 430 
Red value, address for, 250 

Redirect Cascade interrupt, 9, 77, 51 
Redirection of Diskette Service, 252 


Reference diskette 
or ADF files, 28, 49 
and passwords, 54 
for POST, 97, 113 


Refresh register in DMA controller, 43 
Refresh verification failure, 442, 454 


Remote mode, mouse, 479 
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Resends, Intel 8042 Emote 
467-468 
keyboard commands and reply for, 
473, 475-476 
mouse command and reply for, 
479-480 


Reset Diskette System, Diskette 
Service, 269 


Reset Diskette(s) and Fixed Disk, 
Fixed Disk Service, 304 


RESET input, CPU, 36 


Reset pointing device subfunction, 
388 


Reset Real Time Clock Alarm, Time- 
of-Day Service, 418 


Resetting 
of fixed disk, alternate, 318-319 
of keyboard, 475 
of mouse, 479 
pointer to code for, 80 
of system, 112, 136 
vector for, 112 


~ Resolution 

of default fonts, 179 

of mouse, 477 

of pointing devices, 390 
of video modes, 174-175 


Restore current video state subfunc- 
tion, 244 


Return base POS adapter register 
address subfunction, 396 


Return Extended BIOS Data Area, 
System Services, 385 


Return Extended Keyboard Status, 
Keyboard Service, 149 


Return Extended Shift Flags Status, 
Keyboard Service, 150 


Return Functionality/State OnAAHON, 


Video Service, 237-241 
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Return Keyboard Status, Keyboard 
Service, 144-145 


Return save/restore buffer size 
needed video subfunction, 243 


Return Shift Flag Status, Keyboard 
Service, 145 


Return status pointing device subfunc- 
tion, 392 


Return System Configuration Parame- 
ters, System Services, 103, 
383-384 


Return VGA Information video sub- 
function, 230-231 


Return Video Status, Video Service, 
203 . 


Revision level in System Configuration 
Table, 102, 362, 383 


RGB analog values in DAC, 31, 169, 
208 


ROM and ROM BIOS, 5, 99 

baud rate initialization, 110 

character generators for Video 
Service in, 178-179 

checksum failure in, 442, 454 

compatibility table for, 100-101 

diskette parameters table, 105-106 

for Diskette Service, 264-265 

for ESDI drives, 288 

feature control, 103-104 

fixed disk parameters table, 
107-109 

for Fixed Disk Service, 298-300 

graphics mode fonts in, 225-227 

initialization and testing of, 113 

I/O expansion, 115 

option, checksum failure in, 444, 
457 

for Serial Communications Service, 
338 

System Configuration Table, 102 

for System Services, 362 
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text mode fonts in, 215, 217, 
220-222 
video, failure of, 443, 454 
video expansion, 115 


Rows, screen, 81, 180, 238, 248, 
429 


RS-232 devices, 337, 356 
Run time errors, 451-452 


S 


Sample rate for pointing devices, 
389, 479 


Save current video state subfunction, 
244 


Save/Restore Video State, Video 
Service, 242-250 


Scaling 
cursor, 233 
mouse, 4/77 
pointing device, 393 


Scan codes, 133, 368, 474 


Scan lines, 31, 505 
selection of, for text modes, 232 
in video modes, 239-240 


Scratch register, 67, 73, 334, 336, 
498 


Screen 
clearing of, 187 
columns on, 80, 180, 248 
dimensions of, 174-175 
failure of memory for, 443, 454 
printing of, 429-430 
rows on, 81, 180, 248, 429 
settings for, 203 
See also Video 


Scroll Current Page Up/Down, Video 
Service, 193 


Scroll Lock key, 133, 136-137 
and pause state table, 139 


index 


status of, 145 


Seagate fixed disks, 108, 299 


Second text mode auxiliary character 


generator, 185 


Secondary Video table, 181, 184-186 


Seconds 


in CMOS RAM, 411 
in real time clock, 90, 489 


Sectors 


boot, loading of, 433-437 
bytes per, 105, 264 
fixed disk 
long, reading of, 314-316 
reading of, 306-307 
verifying of, 309 
writing of, 308 
number of, 275 
reading of, 271 
track 
diskette, 254 
fixed disk, 107-109, 298 


Security, Keyboard, 435, 453, 470 
Seek to Cylinder, Fixed Disk Service, 


317 


Select color paging mode video sub- 


function, 210 


Select New Video Page, Video 


Service, 192 


Select scan lines for text modes 


video subfunction, 232 


Self test, Intel 8042, 471 
Send Character, Video Service, 342 
Sequencer, VGA, 30, 169 


registers for, 69, 172, 245, 493 


Serial ports, 491, 502 


addresses for, 65-67, 71-73, 
332-336 

controller for, 34-35, 331, 502 

entry point for, 100 
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S, cont’d 
error handling for, 339 
failure of, 447 
hardware environment for, 34-35, 
331 
initialization and testing of, 114 
interrupts for, 8, 76 
I/O ports for, 332-336 
IRQ assignment for, 51 
registers for, 496-498 
ROM BIOS data for, 338 
services for, 19, 329-330 
Extended Initialize, 345-346 
Extended Serial Port Control, 
347-350 
Initialize Serial Communications 
Port, 340-341 
Read Serial Port Status, 344 
Receive Character, 343 
Send Character, 342 
System RAM for, 337 | 
time-out table for, 81, 337 


Serial terminal, display as, 201 
Serial-to—parallel conversions, 35 


Set all palette registers and overscan 
video subfunction, 206 


Set block of color registers video 
subfunction, 209 


Set block specifier video subfunction, 
216-217 


Set Color Palette, Video Service, 198 


Set Cursor Position, Video Service, 
190 


Set Cursor Type, Video Service, 
188-189 


Set Diskette Type, Diskette Service, 
280 


Set Event Wait Interval, System 
Services, 371-372 


Set individual color register video 
subfunction, 208 


Set interval wait subfunction, 372 
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Set Media Type for Format, Diskette 
Service, 281 


Set overscan register video subfunc- 
tion, 205 


Set Palette/Color Registers, Video 
Service, 204 
Read all palette registers and over- 
scan, 207 
Read block of color registers, 211 
Read color paging status, 212 
Read individual palette register, 207 
Read overscan register, 207 
Read single DAC color register, 211 
Select color paging mode, 210 
Set all palette registers and over- 
scan, 206 
Set block of color registers, 209 
Set individual color register, 208 
Set overscan register, 205 
Set single palette, 205 
Sum color values to gray shades, 
212 
Toggle intensity/blink bit, 206 


Set Real Time Clock Alarm, Time-of- 
Day Service, 417 


Set Real Time Clock Date, Time-of- 
Day Service, 416 


Set Real Time Clock Time, Time-—of-— 
Day Service, 414 


Set resolution pointing device sub- 
function, 390 


Set sample rate pointing device sub- 
function, 389 


Set scaling factor to 1:1 pointing de- 
vice subfunction, 393 


Set scaling factor to 2:1 pointing de- 
vice subfunction, 393 


Set single palette video subfunction, 


205 


Set System Timer Day Counter, 
Time-of-Day Service, 419 
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Set System Timer Time Counter, 
Time—of—Day Service, 413 


Set Typematic Rate and Delay, Key- 
board Service, 146 


Set user graphics font pointer at INT 
1Fh video subfunction, 223 


Set user graphics font pointer at INT 
43h video subfunction, 224 


Set Video Mode, Video Service, 187 


Setup enable register, system board, 
61, 358, 436 
Sharing 


of buses, 41 
of interrupts, 514 


Shift key, 133 
and character code tables, 153-162 
flags for, 79, 134-135, 145, 150 
and pause state table, 139 


Shift and Print Screen keys, 136 


Shutdown 
code values for, 116 
failure message for, 457 
reason for, in CMOS RAM, 92, 361 


Sign-on password control, 435 
Single function services, 427-437 
Single Step interrupt, 8, 76 
Single-tasking operating systems, 25 


Size 
of characters, 174-175 
Current page, 80, 180, 248 
cursor, 188 
of diskette drives, 254-255 
of memory, 94, 97, 358, 432 
service for, 8, 17, 76, 100, 432 


Slave DMA register failure, 443 
Slave PIC, 425 


Software interrupts, 7-12 


Index 


Software Triggered Strobe system 
timer mode, 37, 510 


Software vector number, 487 
Speeds, microprocessor, 25, 499 


Spelling utility, screen reading with, 
194 


Square Wave system timer mode, 
37, 510 


ST506 fixed disk adapter, 29, 288, 
504 


Standard memory, message for, 450, 
458 


Start time, diskette motor, 106, 265 


Status and status registers 

of auxiliary device, 392 

CMOS RAM, 91, 361, 425 

of diskette motors, 79, 259, 421 

for diskettes, 70, 80, 257, 260, 
270, 283 

in DMA controller, 43, 55, 62, 257, 
482 

extended keyboard, 149 

extended shift flags, 150 

for fixed disk, 82, 305, 492 

keyboard, 135, 144-145, 464 

from last disk operation, 81, 260, 
293 

for mouse, 478 

parallel port, 33, 65, 68, 401-402, 
491, 493, 503 

for print screen, 84, 429 

printer, reading of, 406 

real time clock, 418, 489 

serial port, 344 

shift flag, 145 

system board, 515 

system RAM, 83-84 

Time-of-Day, 411 

VGA, 495 

video, 203, 237-241, 244 


Stop bits, serial port, 34, 331, 340, 
345, 502 
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Store Key Data service, 147 


Stream mode for mouse, 478 


Strike the Fi key to continue mes- 
sage, 450, 458 


Strings, writing of, 235 
Subaddress extension, POS, 64 
Subfunctions, 10, 13 


Submodel byte in System Configura- 
tion Table, 102, 362, 383 


Sum color values to gray shades 
video subfunction, 212 


Switch data, EGA/VGA, 82, 181, 249 
Switch Display video subfunction, 234 


Switch Processor to Protected Mode, 
System Services, 379-380 


Switch to alternate print screen rou- 
tine video subfunction, 231 


SysReq key, 136, 141 
service for, 374 


System 

booting of, 117 

clock generator for, 501 

configuration parameters for, 363, 
383-384 

failure of, 440, 444-448 

gate array for, 501 

Keyboard communication with, 
132-133, 470-472, 474-476 

keyboard status register flag for, 
464 | 

messages for, 202 

mouse commands for, 477-480 

reset flag for, 81, 437 

resetting of, 136 

scan codes for, 133, 151 


System board 
copy of, 94 
failure of, 444-445 
setup of, 64 
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status of, 487, 515 


System Board Memory Failure mes- 
sage, 124, 452 


System Configuration Table, 102, 
362, 383-384 


_ System control ports 


addresses for, 59-61, 121-122, 
172, 291, 357, 422, 436, 487 
definition for, 52-53, 515 


System halted! message, 435, 453 


System model ID, ROM compatible 
address for, 101 


System Parameters table, building of, 
(363 


System RAM, 4-6, 75 

CBIOS data area, 78-84, 293 

CBIOS extended data area, 85-86 

for Diskette Service, 259-262 

for Fixed Disk Service, 293-294 

initialization and testing of, 113-114 

interrupt vectors for, 76-77 

for Keyboard Service, 134-135 

for Parallel Printer Service, 403 

for Serial Communications Service, 
337 | 

for System Services, 359 

for Time-—of—Day Service, 410, 421, 
424 

for Video Service, 180-186 


System request and System Request 
Key service, 136, 141, 374 . 


System Reset, Keyboard Service, 136 


System Services, 19-21, 351-355 
Build Initialization Table, 364 
Build System Parameters Table, 

363 
CMOS RAM for, 361 
Device Busy, 381 
Device Close, 369 
Device Open, 369 
entry point for, 100 
extended System RAM for, 360 
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Format ESDI Drive Periodic 
Interrupt, 365 

hardware environment for, 356 

interrupt for, 8, 76 

Interrupt Complete, 382 

I/O ports for, 356-358 

Joystick Support, 373-374 

Keyboard Intercept, 368 

Move Block, 376-377 

Pointing Device Interface, 386-394 

Power-On Self Test Error Log, 
366-367 

Program Termination, 370 

Programmable Option Select, 
396-397 

Read Extended Memory Size, 378 

Return Extended BIOS Data Area, 
385 

Return System Configuration Param- 
eters, 383-384 

ROM BIOS data for, 362 

Set Event Wait interval, 371-372 

Switch Processor to Protected 
Mode, 379-380 

System RAM for, 359 

System Request Key, 374 

Wait, 375 

Watchdog Time-—-Out, 395 


System timer and time-related 
devices, 36-39, 507 
channel for, 38, 507, 509 
counter for, 412-413, 418-419, 486 
entry point for, 100 
interrupt for, 8, 76 


System Timer & Real-Time Clock 
interrupt, 9, 77 


system Timer ISR Time-of-—Day 
Service, 420-422 


+ 


Table of Interrupt Vectors, 5 
Tandon fixed disks, 108, 299 


Index 


Temporary Holding register, DMA 
controller, 43, 483 


Termination of programs, 370 
Test buffers, fixed disk, 320-321 


Test for Drive Ready, Fixed Disk 
Service, 322 


Test inputs, Keyboard, 472 
Test port, keyboard, 465 


Text modes, 174-176 
auxiliary Character generator for, 
182, 185 
fonts for 
dot, 178 
double dot, 215, 221 
ROM, 215, 217, 220-222 
user, 214, 219 
scan lines selection for, 232 
writing to screen in, 196 


Thesaurus utility, screen reading with, 
194 


Tick count, 410 


Time and timer 

channels in, 37-38, 507, 509 

count for, 80, 357, 410, 421, 424 

error messages for, 457 

Intel 8042 firmware for, 468 

Interrupt for, 51 

real time clock, reading and setting 
of, 413-414 

system devices for, 36-39, 507 

system message for, 445 


Time-of-Day clock stopped message, 
457 


Time-of-Day Service, 22, 407-409 
CMOS RAM for, 410-411, 425 
entry point for, 100 
error handling for, 412 
hardware environment for, 410, 

421, 424 
I/O ports for, 422, 425 
Real Time Clock ISR, 423-425 
services for, 412-422 
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Read Real Time Clock Alarm and 
Status, 418 
Read Real Time Clock Date, 415 
Read Real Time Clock Time, 413 
Read System Timer Day Counter, 
418 
Read System Timer Time 
Counter, 412 
Reset Real Time Clock Alarm, 418 
Set Real Time Clock Alarm, 417 
set Real Time Clock Date, 416 
Set Real Time Clock Time, 414 
Set System Timer Day Counter, 
419 
Set System Timer Time Counter, 
413 
System RAM for, 410, 421, 424 
System Timer ISR, 420-422 


Time-—out 
diskette motor count for, 79, 259, 
421 
errors from, 339 
handling of, 125-126 
messages for, 451-452 
in keyboard status register, 464 
printer table for, 81 
serial table for, 81, 337 


Toggle intensity/blink bit video sub- 
function, 206 _ 


Toggle keys, 133 


Tone Generation for Speaker timer 
channel, 38 


Touch pads, 356 


Track 
diskette, 254 
end of, 106, 264 
formatting of, 274-275 
number, 83, 262 
fixed disk sectors per, 107, 298 


Trackballs, 32, 356 
Transfer control bytes, DMA, 44 
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Transfer count register, DMA, 55, 62, 
257, 482 


Transfer rates, diskette, 82, 256, 
261, 280 


Transfer status flags, DMA, 42-43 


Transmitter holding register, 65, 71, 
332, 334, 496 | 


Trigonometric operations, 26, 500 


Turn off delay, diskette motor drive, 
105, 264 


24-hour roll over flag, 80, 410, 421, 
424 


200-line modes, 176-177 


Type 
of cursor, 80, 180, 188-189, 248 
of diskette drives, 263, 278, 280 
of fixed disk, 92, 295, 324 
of media, 83, 254, 261, 281 


Typematic rate and delay, 146, 474 


U 


Use ROM 8x8 double dot font for 
graphics video subfunction, 226 


Use ROM 8x14 font for graphics video 
subfunction, 225 


Use ROM 8x16 font for graphics video 
subfunction, 227 


User Alarm interrupt, 9, 77 

User graphics font pointer, 223-224 
User interrupts, 7-9, 77 

User palette profile table, 186 

User text mode fonts, 214, 219 
User Timer Tick interrupt, 9, 77 
User wait flag, 84, 359, 424 


CBIOS for IBM PS/2 Computers and Compatibles 


V 
Vectors, 5-9, 487 


Verify Disk Sectors, Fixed Disk 
Service, 309 


Verify Diskette Sectors, Diskette 
Service, 273 


VGA. See Video Graphics Array 


Video 
buffer for, 174-175, 238, 243 
Character Generator, 213-228 
control bits for, 82, 180, 249 
entry point for, 100 
expansion ROM for, 115 
failure of, 448 
hardware for, 30-31, 504-505 
hardware environment for, 168-171 
I/O ports for, 172-173 
interrupt for, 8, 76 
memory for, 30-31, 171, 239, 505 
modes for, 80, 174-176, 180, 187, 
248 : 
monitor support for, 177 
pages for. See Pages, video 
ROM character generators for, 
178-179 
ROM failure for, 443, 454 
services for, 13-16, 163-167 
Alternate Select, 229-234 
Read Character/Attribute from 
Screen, 194 
Read Current Cursor Position, 191 
Read Light Pen Position, 191 
Read Pixel, 200 
Read/Write Display Combination 
Code, 236-237 
Return Functionality/State Infor- 
mation, 237-241 
Return Video Status, 203 
Save/Restore Video State, 
242-250 
Scroll Current Page Up/Down, 193 
select New Video Page, 192 
Set Color Palette, 198 
Set Cursor Position, 190 
Set Cursor Type, 188-189 


Index 


Set Palette/Color Registers, 
204-212 
Set Video Mode, 187 
Write Character/Attribute to 
Screen, 195-196 
Write Character Only to Screen, 
197 
Write Pixel, 199 
Write String, 235 
Write Teletype to Active Page, 
201-202 
Status of, 203 
subsystem enable, 69, 172, 493 
system RAM data for, 180-186 
See also Screen 


Video Graphics Array 

chip set for, 30, 168-170, 505 

cursor with, 189 

display code for, 236 

I/O port registers for, 495 

parameter tables for, 9, 77, 84, 
100, 181-182, 249 

port addresses for, 68-69, 
172-173, 493-495 

returning information about, 230 

screen writing in, 196 

video paging in, 192 


Video Graphics Characters interrupt, 
9, 77 


Video screen ON/OFF subfunction, 
234 


Video Service pointer table #2, 183 
Virtual DMA channels, 47 


W 


Wait active flag, 84, 262, 359, 424 
Wait count, 84, 359, 424 
Wait interval, event, 371-372 


WAIT math coprocessor signal, 26, 
500 


555 


W, cont'd 
Wait states, microprocessor, 25, 499 
Wait System Services, 375 
Warm boots, 112 


Watchdog Time-—out message, 126, 
451-452 


Watchdog Time—-Out, System 
Services, 395 


Watchdog Timer 
channel for, 38 
initial count in, 86, 421 
and time-out errors, 125-126 


Western Digital ST506 fixed disk 
adapter, 29, 504 


Width 
I/O address, 27 
of screen, 203 


Windows, initialization of, 193 
Wrap mode, mouse, 478 


Write Character/Attribute to Screen, 
Video Service, 195-196 


Write Character Only to Screen, 
Video Service, 197 


Write Disk Sectors, Fixed Disk 
Service, 308 


— -+556 
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Write error code to POST error log 
subfunction, 367 
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Write Mask Register, DMA, 63 
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Write operation for System Control 
Port, 52 
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